ListViewInsertEventArgs.Values Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.IOrderedDictionaryPublic ReadOnly Property Values As IOrderedDictionaryEigenschaftswert
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.
