ListViewUpdateEventArgs.NewValues Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém um dicionário que contém os valores revistos do item para 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 de Propriedade
Os valores revistos do item para atualizar.
Exemplos
O exemplo seguinte mostra como usar a NewValues propriedade para garantir que o utilizador forneceu todos os valores antes de a fonte de dados ser 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
Observações
Use a NewValues propriedade (dicionário) para aceder aos valores dos campos não-chave revistos no item para atualizar.
Note
O campo ou campos da chave primária estão incluídos neste dicionário se o valor ou valores da chave primária estiverem a ser atualizados. Para aceder aos valores originais do campo ou campos da chave primária, use a Keys propriedade. Para aceder aos valores originais dos campos não-chave no item, use a OldValues propriedade.
A NewValues propriedade é automaticamente preenchida com os pares nome/valor dos campos revistos no item. Uma entrada separada é adicionada à NewValues propriedade para cada campo do 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.