ListViewUpdateEventArgs.NewValues Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera słownik zawierający poprawione wartości elementu do zaktualizowania.
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 IOrderedDictionaryWartość właściwości
Poprawione wartości elementu do zaktualizowania.
Przykłady
W poniższym przykładzie pokazano, jak za pomocą NewValues właściwości upewnić się, że użytkownik podał wszystkie wartości przed zaktualizowaniem źródła danych. Ten przykład kodu jest częścią większego przykładu udostępnionego dla klasy 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
Uwagi
NewValues Użyj właściwości (słownika), aby uzyskać dostęp do wartości poprawionych pól innych niż klucz w elemencie w celu zaktualizowania.
Uwaga / Notatka
Pole lub pola klucza podstawowego są uwzględniane w tym słowniku, jeśli jest aktualizowana wartość klucza podstawowego lub wartości. Aby uzyskać dostęp do oryginalnych wartości pola lub pola klucza podstawowego, użyj Keys właściwości . Aby uzyskać dostęp do oryginalnych wartości pól innych niż klucz w elemencie, użyj OldValues właściwości .
Właściwość NewValues jest wypełniana automatycznie parami nazw/wartości poprawionych pól w elemencie. Oddzielny NewValues wpis jest dodawany do właściwości dla każdego pola w elemencie.
Aby określić nazwę pola wpisu, użyj DictionaryEntry.Key właściwości DictionaryEntry obiektu zawartego w słowniku NewValues . Aby określić wartość wpisu, użyj DictionaryEntry.Value właściwości .
