ListViewInsertEventArgs.Values 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 os valores do registo a inserir.
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.IOrderedDictionaryPublic ReadOnly Property Values As IOrderedDictionaryValor de Propriedade
Os valores para o registo inserir.
Exemplos
O exemplo seguinte mostra como iterar pela 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
Observações
Use a Values propriedade para aceder aos valores dos campos para o registo inserir. Por exemplo, pode validar ou codificar em HTML os valores do registo antes de este ser inserido na fonte de dados.
A Values propriedade devolve um OrderedDictionary objeto que implementa a IOrderedDictionary interface. O OrderedDictionary objeto contém DictionaryEntry objetos que representam os campos do registo. Para aceder aos nomes dos campos, use a Keys propriedade do OrderedDictionary objeto. Para aceder aos valores dos campos, use a Values propriedade.
Note
Como atalho, pode usar o indexador do OrderedDictionary objeto para aceder diretamente aos valores do campo. A vantagem de usar o indexador é que ele retorna diretamente os valores dos campos. Os controlos de fonte de dados que dependem da ordem do campo (como AccessDataSource) só podem aceder aos valores do campo por índice.
