ListViewUpdateEventArgs.NewValues Eigenschaft

Definition

Ruft ein Wörterbuch ab, das die überarbeiteten Werte des zu aktualisierenden Elements enthält.Gets a dictionary that contains the revised values of the item to update.

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

Eigenschaftswert

Die überarbeiteten Werte des zu aktualisierenden Elements.The revised values of the item to update.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die NewValues -Eigenschaft verwendet wird, um sicherzustellen, dass der Benutzer alle Werte bereitgestellt hat, bevor die Datenquelle aktualisiert wird.The following example shows how to use the NewValues property to make sure that the user has supplied all values before the data source is updated. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ListViewUpdateEventArgs -Klasse bereitgestellt wird.This code example is part of a larger example provided for the ListViewUpdateEventArgs class.

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

Hinweise

Verwenden Sie NewValues die-Eigenschaft (Wörterbuch), um auf die Werte der überarbeiteten nicht Schlüsselfelder im zu aktualisierenden Element zuzugreifen.Use the NewValues property (dictionary) to access the values of the revised non-key fields in the item to update.

Hinweis

Die Primärschlüssel Felder werden in dieses Wörterbuch eingeschlossen, wenn der Primärschlüssel Wert oder die Werte aktualisiert werden.The primary key field or fields are included in this dictionary if the primary key value or values are being updated. Verwenden Sie die Keys -Eigenschaft, um auf die ursprünglichen Werte des Primärschlüssel Felds oder der Felder zuzugreifen.To access the original values of the primary key field or fields, use the Keys property. Um auf die ursprünglichen Werte der nicht Schlüsselfelder im Element zuzugreifen, verwenden Sie die OldValues -Eigenschaft.To access the original values of the non-key fields in the item, use the OldValues property.

Die NewValues -Eigenschaft wird automatisch mit den Name-Wert-Paaren der überarbeiteten Felder im Element aufgefüllt.The NewValues property is automatically populated with the name/value pairs of the revised fields in the item. Der NewValues -Eigenschaft wird für jedes Feld im Element ein separater Eintrag hinzugefügt.A separate entry is added to the NewValues property for every field in the item.

Um den Feldnamen eines Eintrags zu ermitteln, verwenden DictionaryEntry.Key Sie die- DictionaryEntry Eigenschaft eines-Objekts, NewValues das im Wörterbuch enthalten ist.To determine the field name of an entry, use the DictionaryEntry.Key property of a DictionaryEntry object that is contained in the NewValues dictionary. Um den Wert eines Eintrags zu ermitteln, verwenden DictionaryEntry.Value Sie die-Eigenschaft.To determine the value of an entry, use the DictionaryEntry.Value property.

Gilt für:

Siehe auch