Freigeben über


ListViewInsertEventArgs.Values Eigenschaft

Definition

Ruft die Werte für den einzufügenden Datensatz ab.

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

Eigenschaftswert

Die Werte für den einzufügenden Datensatz.

Beispiele

Das folgende Beispiel zeigt, wie Sie die Values Auflistung durchlaufen. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ListViewInsertEventArgs-Klasse bereitgestellt wird.

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

Hinweise

Verwenden Sie die Values -Eigenschaft, um auf die Werte der Felder für den einzufügenden Datensatz zuzugreifen. Beispielsweise können Sie die Werte des Datensatzes überprüfen oder HTML-codieren, bevor er in die Datenquelle eingefügt wird.

Die Values -Eigenschaft gibt ein OrderedDictionary -Objekt zurück, das die IOrderedDictionary -Schnittstelle implementiert. Das OrderedDictionary -Objekt enthält DictionaryEntry -Objekte, die die Felder des Datensatzes darstellen. Verwenden Sie die -Eigenschaft des OrderedDictionary -Objekts, um auf die Keys Feldnamen zuzugreifen. Verwenden Sie die -Eigenschaft, um auf die Values Feldwerte zuzugreifen.

Hinweis

Als Verknüpfung können Sie den Indexer des OrderedDictionary Objekts verwenden, um direkt auf die Feldwerte zuzugreifen. Der Vorteil der Verwendung des Indexers besteht darin, dass Feldwerte direkt zurückgegeben werden. Datenquellensteuerelemente, die auf der Feldreihenfolge basieren (z AccessDataSource. B. ), können nur nach Index auf Feldwerte zugreifen.

Gilt für:

Weitere Informationen