ListViewUpdateEventArgs.NewValues Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Ruft ein Wörterbuch ab, das die überarbeiteten Werte des zu aktualisierenden Elements enthält.

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

IOrderedDictionary

Die überarbeiteten Werte des zu aktualisierenden Elements.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie die NewValues -Eigenschaft verwenden, um sicherzustellen, dass der Benutzer alle Werte angegeben hat, bevor die Datenquelle aktualisiert wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ListViewUpdateEventArgs-Klasse bereitgestellt wird.

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 die NewValues Eigenschaft (Wörterbuch), um auf die Werte der überarbeiteten Nichtschlüsselfelder im zu aktualisierenden Element zuzugreifen.

Hinweis

Die Primärschlüsselfelder sind in diesem Wörterbuch enthalten, wenn der Primärschlüsselwert oder die Primärschlüsselwerte aktualisiert werden. Verwenden Sie die -Eigenschaft, um auf die ursprünglichen Werte des Primärschlüsselfelds oder der Keys Primärschlüsselfelder zuzugreifen. Verwenden OldValues Sie die -Eigenschaft, um auf die ursprünglichen Werte der Nichtschlüsselfelder im Element zuzugreifen.

Die NewValues -Eigenschaft wird automatisch mit den Namen-Wert-Paaren der überarbeiteten Felder im Element aufgefüllt. Für jedes Feld im Element wird der NewValues -Eigenschaft ein separater Eintrag hinzugefügt.

Um den Feldnamen eines Eintrags zu bestimmen, verwenden Sie die DictionaryEntry.Key Eigenschaft eines DictionaryEntry Objekts, das NewValues im Wörterbuch enthalten ist. Verwenden Sie die -Eigenschaft, um den DictionaryEntry.Value Wert eines Eintrags zu bestimmen.

Weitere Informationen

• Keys
• OldValues
• IOrderedDictionary
• Key
• Value
• Technologieübersicht: Das ListView-Steuerelement