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 свойство.
