ListViewUpdateEventArgs.NewValues Özellik

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.Extensions.dll

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

IOrderedDictionary

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 .

Ayrıca bkz.

• Keys
• OldValues
• IOrderedDictionary
• Key
• Value
• Teknolojiye Genel Bakış: ListView Denetimi