ListViewInsertEventArgs.Values Propiedad

Definición

Obtiene los valores del registro que se va a insertar.

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 de propiedad

IOrderedDictionary

Valores del registro que se va a insertar.

Ejemplos

En el ejemplo siguiente se muestra cómo recorrer en iteración la Values colección. Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la ListViewInsertEventArgs clase .

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

Comentarios

Utilice la Values propiedad para tener acceso a los valores de los campos del registro que se va a insertar. Por ejemplo, puede validar o codificar HTML los valores del registro antes de insertarlos en el origen de datos.

La Values propiedad devuelve un OrderedDictionary objeto que implementa la IOrderedDictionary interfaz . El OrderedDictionary objeto contiene DictionaryEntry objetos que representan los campos del registro. Para tener acceso a los nombres de campo, use la Keys propiedad del OrderedDictionary objeto . Para tener acceso a los valores de campo, use la Values propiedad .

Nota

Como acceso directo, puede usar el indexador del OrderedDictionary objeto para acceder directamente a los valores de campo. La ventaja de usar el indexador es que devuelve valores de campo directamente. Los controles de origen de datos que se basan en el orden de campo (como AccessDataSource) solo pueden tener acceso a los valores de campo por índice.

Se aplica a

Consulte también