ListViewUpdateEventArgs.NewValues Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un dizionario che contiene i valori modificati dell'elemento da aggiornare.
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 IOrderedDictionaryValore della proprietà
Valori modificati dell'elemento da aggiornare.
Esempio
Nell'esempio seguente viene illustrato come utilizzare la NewValues proprietà per assicurarsi che l'utente abbia fornito tutti i valori prima dell'aggiornamento dell'origine dati. Questo esempio di codice fa parte di un esempio più ampio fornito per la ListViewUpdateEventArgs classe .
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
Commenti
Utilizzare la NewValues proprietà (dizionario) per accedere ai valori dei campi non chiave modificati nell'elemento da aggiornare.
Nota
Il campo o i campi della chiave primaria vengono inclusi in questo dizionario se il valore o i valori della chiave primaria vengono aggiornati. Per accedere ai valori originali del campo o dei campi della chiave primaria, utilizzare la Keys proprietà . Per accedere ai valori originali dei campi non chiave nell'elemento, utilizzare la OldValues proprietà .
La NewValues proprietà viene popolata automaticamente con le coppie nome/valore dei campi modificati nell'elemento. Viene aggiunta una voce separata alla NewValues proprietà per ogni campo dell'elemento.
Per determinare il nome del campo di una voce, utilizzare la DictionaryEntry.Key proprietà di un DictionaryEntry oggetto contenuto nel NewValues dizionario. Per determinare il valore di una voce, utilizzare la DictionaryEntry.Value proprietà .
