ListViewUpdateEventArgs.NewValues Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.IOrderedDictionaryPublic ReadOnly Property NewValues As IOrderedDictionaryValor 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 .
