ListViewUpdateEventArgs.NewValues Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает словарь исправленных значений обновляемого элемента.
public:
property System::Collections::Specialized::IOrderedDictionary ^ NewValues { System::Collections::Specialized::IOrderedDictionary ^ get(); };public System.Collections.Specialized.IOrderedDictionary NewValues { get; }member this.NewValues : System.Collections.Specialized.IOrderedDictionaryPublic ReadOnly Property NewValues As IOrderedDictionaryЗначение свойства
Исправленные значения обновляемого элемента.
Примеры
В следующем примере показано, как использовать NewValues свойство , чтобы убедиться, что пользователь предоставил все значения перед обновлением источника данных. Этот пример входит в состав более крупного примера использования класса ListViewUpdateEventArgs.
void ContactsListView_ItemUpdating(Object sender, ListViewUpdateEventArgs e)
{
// Cancel the update operation if any of the fields is empty
// or null.
foreach (DictionaryEntry de in e.NewValues)
{
// Check if the value is null or empty.
if (de.Value == null || de.Value.ToString().Trim().Length == 0)
{
Message.Text = "Cannot set a field to an empty value.";
e.Cancel = true;
}
}
// Convert the email address to lowercase.
String emailValue = e.NewValues["EmailAddress"].ToString();
e.NewValues["EmailAddress"] = emailValue.ToLower();
}
Sub ContactsListView_ItemUpdating(ByVal sender As Object, ByVal e As ListViewUpdateEventArgs)
' Cancel the update operation if any of the fields is empty
' or null.
For Each de As DictionaryEntry In e.NewValues
' Check if the value is null or empty
If de.Value Is Nothing OrElse de.Value.ToString().Trim().Length = 0 Then
Message.Text = "Cannot set a field to an empty value."
e.Cancel = True
End If
Next
' Convert the email address to lowercase.
Dim emailValue As String = e.NewValues("EmailAddress").ToString()
e.NewValues("EmailAddress") = emailValue.ToLower()
End Sub
Комментарии
NewValues Используйте свойство (словарь) для доступа к значениям измененных неключевых полей в обновляемом элементе.
Примечание
Поле или поля первичного ключа включаются в этот словарь, если обновляется значение или значения первичного ключа. Чтобы получить доступ к исходным значениям поля первичного ключа или полей, используйте Keys свойство . Чтобы получить доступ к исходным значениям неключевых полей в элементе OldValues , используйте свойство .
Свойство NewValues автоматически заполняется парами "имя-значение" измененных полей в элементе. В свойство для каждого поля элемента добавляется NewValues отдельная запись.
Чтобы определить имя поля записи, используйте DictionaryEntry.Key свойство DictionaryEntry объекта, содержащегося в словаре NewValues . Чтобы определить значение записи, используйте DictionaryEntry.Value свойство .
