Compartilhar via


ListViewInsertEventArgs.Values Propriedade

Definição

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.

Aplica-se a

Confira também