Udostępnij za pośrednictwem

ListViewUpdateEventArgs.NewValues Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.Extensions.dll

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.IOrderedDictionary
Public ReadOnly Property NewValues As IOrderedDictionary

Wartość właściwości

IOrderedDictionary

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 dostarczył wszystkie wartości przed zaktualizowaniem źródła danych. Ten przykład kodu jest częścią większego przykładu podanego ListViewUpdateEventArgs dla klasy.

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 zmienionych pól innych niż klucz w elemencie, aby je zaktualizować.

Uwaga

Pole klucza podstawowego lub pola 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 automatycznie wypełniana parami nazw/wartości poprawionych pól w elemencie. Oddzielny wpis jest dodawany do NewValues 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 .

Dotyczy

Zobacz też