ListViewUpdateEventArgs.NewValues Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Güncelleştirilecek öğenin düzeltilmiş değerlerini içeren bir sözlük alır.
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
Özellik Değeri
Güncelleştirilecek öğenin düzeltilmiş değerleri.
Örnekler
Aşağıdaki örnekte, veri kaynağı güncelleştirilmeden önce kullanıcının tüm değerleri sağladığından emin olmak için özelliğinin nasıl kullanılacağı NewValues gösterilmektedir. Bu kod örneği, sınıfı için ListViewUpdateEventArgs sağlanan daha büyük bir örneğin parçasıdır.
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
Açıklamalar
Güncelleştirilecek öğedeki NewValues düzeltilmiş anahtar olmayan alanların değerlerine erişmek için özelliğini (sözlük) kullanın.
Not
Birincil anahtar değeri veya değerleri güncelleştiriliyorsa, birincil anahtar alanı veya alanları bu sözlüğe eklenir. Birincil anahtar alanının veya alanlarının özgün değerlerine erişmek için özelliğini kullanın Keys . Öğedeki anahtar olmayan alanların özgün değerlerine erişmek için özelliğini kullanın OldValues .
NewValues özelliği, öğedeki düzeltilmiş alanların ad/değer çiftleriyle otomatik olarak doldurulur. Öğedeki her alan için özelliğine NewValues ayrı bir giriş eklenir.
Bir girdinin alan adını belirlemek için, sözlükte NewValues yer alan bir DictionaryEntry nesnenin özelliğini kullanınDictionaryEntry.Key. Bir girdinin değerini belirlemek için özelliğini kullanın DictionaryEntry.Value .