ListViewInsertEventArgs.Values Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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 es parte de un ejemplo más grande proporcionado para la clase ListViewInsertEventArgs.
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.