Compartilhar via


ListViewUpdateEventArgs.NewValues Propriedade

Definição

Obtém um dicionário que contém os valores revisados do item a atualizar.

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

Valor da propriedade

Os valores revisados do item a ser atualizado.

Exemplos

O exemplo a seguir mostra como usar a NewValues propriedade para garantir que o usuário tenha fornecido todos os valores antes que a fonte de dados seja atualizada. Este exemplo de código faz parte de um exemplo maior fornecido para a ListViewUpdateEventArgs classe .

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

Comentários

Use a NewValues propriedade (dicionário) para acessar os valores dos campos não chave revisados no item a serem atualizados.

Observação

O campo ou os campos da chave primária serão incluídos neste dicionário se o valor ou os valores da chave primária estiverem sendo atualizados. Para acessar os valores originais do campo ou campos da chave primária, use a Keys propriedade . Para acessar os valores originais dos campos não chave no item, use a OldValues propriedade .

A NewValues propriedade é preenchida automaticamente com os pares nome/valor dos campos revisados no item. Uma entrada separada é adicionada à NewValues propriedade para cada campo no item.

Para determinar o nome do campo de uma entrada, use a DictionaryEntry.Key propriedade de um DictionaryEntry objeto contido no NewValues dicionário. Para determinar o valor de uma entrada, use a DictionaryEntry.Value propriedade .

Aplica-se a

Confira também