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.IOrderedDictionary
Public 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字典中包含的 NewValues 对象的 属性DictionaryEntry。 若要确定条目的值,请使用 DictionaryEntry.Value 属性。

适用于

另请参阅