ListViewUpdateEventArgs.NewValues Vlastnost

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

Upravené hodnoty položky, která se má 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 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 Vlastnost (slovník) použijte pro přístup k hodnotám revidovaných polí bez klíče v položce, kterou chcete aktualizovat.

Poznámka

Pole primárního klíče jsou součástí tohoto slovníku, pokud se hodnota nebo hodnoty primárního klíče aktualizují. Pokud chcete získat přístup k původním hodnotám pole nebo polí primárního klíče, použijte Keys vlastnost . Pokud chcete získat přístup k původním hodnotám jiných než klíčových polí v položce, použijte OldValues vlastnost .

Vlastnost NewValues se automaticky vyplní dvojicemi název/hodnota upravený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 objektu DictionaryEntry , který je obsažen ve slovníku NewValues . K určení hodnoty položky použijte DictionaryEntry.Value vlastnost .

Viz také

• Keys
• OldValues
• IOrderedDictionary
• Key
• Value
• Přehled technologie: Ovládací prvek ListView