ListViewUpdateEventArgs.NewValues Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá slovník, který obsahuje revidované hodnoty položky aktualizovat.
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 IOrderedDictionaryHodnota vlastnosti
Revidované hodnoty položky, které se mají aktualizovat.
Příklady
Následující příklad ukazuje, jak pomocí NewValues vlastnosti zajistit, aby uživatel zadal všechny hodnoty před aktualizací zdroje dat. Tento příklad kódu je součástí většího příkladu uvedeného pro třídu 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
Poznámky
NewValues Použijte vlastnost (slovník) pro přístup k hodnotám revidovaných polí bez klíče v položce, která chcete aktualizovat.
Poznámka:
Pole nebo pole primárního klíče jsou zahrnuta v tomto slovníku, pokud se aktualizuje hodnota nebo hodnoty primárního klíče. Pokud chcete získat přístup k původním hodnotám pole nebo polí primárního klíče, použijte Keys tuto vlastnost. Pokud chcete získat přístup k původním hodnotám polí, která nejsou klíčem v položce, použijte OldValues tuto vlastnost.
Vlastnost NewValues se automaticky vyplní dvojicemi název/hodnota revidovaných polí v položce. Do vlastnosti se přidá NewValues samostatná položka pro každé pole v položce.
Chcete-li určit název pole položky, použijte DictionaryEntry.Key vlastnost DictionaryEntry objektu, který je obsažen ve slovníku NewValues . K určení hodnoty položky použijte DictionaryEntry.Value vlastnost.
