ListViewInsertEventArgs.Values Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

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

IOrderedDictionary

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.

Confira também

• ListView
• IOrderedDictionary
• OrderedDictionary
• DictionaryEntry
• Keys
• Values
• ItemInserting
• Visão geral da tecnologia: o controle ListView