ListViewUpdateEventArgs.NewValues Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.Extensions.dll

Získá slovník, který obsahuje revidované hodnoty položky k aktualizaci.

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

Hodnota vlastnosti

IOrderedDictionary

Revidované hodnoty položky, které se mají aktualizovat.

Příklady

Následující příklad ukazuje, jak použít NewValues vlastnost k zajištění, že uživatel zadal všechny hodnoty před aktualizací zdroje dat. Tento příklad kódu je součástí většího příkladu zadaného ListViewUpdateEventArgs pro třídu.

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 Pomocí vlastnosti (slovníku) můžete získat 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 součástí tohoto slovníku, pokud se aktualizuje hodnota primárního klíče nebo hodnoty. Chcete-li získat přístup k původním hodnotám pole nebo polí primárního klíče, použijte Keys vlastnost. Chcete-li získat přístup k původním hodnotám polí bez klíče v položce, použijte OldValues vlastnost.

Vlastnost NewValues se automaticky vyplní dvojicemi názvů a hodnot 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 . Chcete-li určit hodnotu položky, použijte DictionaryEntry.Value vlastnost.

Platí pro

Viz také