Condividi tramite


ListViewInsertEventArgs.Values Proprietà

Definizione

Ottiene i valori per il record da inserire.

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

Valore della proprietà

Valori per il record da inserire.

Esempio

Nell'esempio seguente viene illustrato come scorrere la Values raccolta. Questo esempio di codice fa parte di un esempio più ampio fornito per la 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

Commenti

Utilizzare la Values proprietà per accedere ai valori dei campi per il record da inserire. Ad esempio, è possibile convalidare o codificare HTML i valori del record prima di essere inseriti nell'origine dati.

La Values proprietà restituisce un OrderedDictionary oggetto che implementa l'interfaccia IOrderedDictionary . L'oggetto OrderedDictionary contiene DictionaryEntry oggetti che rappresentano i campi del record. Per accedere ai nomi dei campi, utilizzare la Keys proprietà dell'oggetto OrderedDictionary . Per accedere ai valori dei campi, utilizzare la Values proprietà .

Annotazioni

Come collegamento, è possibile usare l'indicizzatore dell'oggetto OrderedDictionary per accedere direttamente ai valori dei campi. Il vantaggio dell'uso dell'indicizzatore è che restituisce direttamente i valori dei campi. I controlli origine dati che si basano sull'ordine dei campi (ad esempio AccessDataSource) possono accedere ai valori dei campi solo in base all'indice.

Si applica a

Vedi anche