ListViewInsertEventArgs.Values 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 os valores para o registro a ser inserido.
public:
property System::Collections::Specialized::IOrderedDictionary ^ Values { System::Collections::Specialized::IOrderedDictionary ^ get(); };
public System.Collections.Specialized.IOrderedDictionary Values { get; }
member this.Values : System.Collections.Specialized.IOrderedDictionary
Public ReadOnly Property Values As IOrderedDictionary
Valor da propriedade
Os valores do registro a ser inserido.
Exemplos
O exemplo a seguir mostra como iterar por meio da Values coleção. Este exemplo de código faz parte de um exemplo maior fornecido para a ListViewInsertEventArgs classe .
void ContactsListView_ItemInserting(Object sender, ListViewInsertEventArgs e)
{
// Iterate through the values to verify if they are not empty.
foreach (DictionaryEntry de in e.Values)
{
if (de.Value == null)
{
Message.Text = "Cannot insert an empty value.";
e.Cancel = true;
}
}
}
Sub ContactsListView_ItemInserting(ByVal sender As Object, _
ByVal e As ListViewInsertEventArgs)
' Iterate through the values to verify if they are not empty.
For Each de As DictionaryEntry In e.Values
If de.Value Is Nothing Then
Message.Text = "Cannot insert an empty value."
e.Cancel = True
End If
Next
End Sub
Comentários
Use a Values propriedade para acessar os valores dos campos para o registro a ser inserido. Por exemplo, você pode validar ou codificar HTML os valores do registro antes que ele seja inserido na fonte de dados.
A Values propriedade retorna um OrderedDictionary objeto que implementa a IOrderedDictionary interface . O OrderedDictionary objeto contém DictionaryEntry objetos que representam os campos do registro. Para acessar os nomes de campo, use a Keys propriedade do OrderedDictionary objeto . Para acessar os valores de campo, use a Values propriedade .
Observação
Como atalho, você pode usar o indexador do OrderedDictionary objeto para acessar os valores de campo diretamente. A vantagem de usar o indexador é que ele retorna valores de campo diretamente. Os controles de fonte de dados que dependem da ordem de campo (como AccessDataSource) podem acessar valores de campo somente por índice.