ListViewInsertEventArgs.Values Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de waarden op voor de record die moet worden ingevoegd.
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 IOrderedDictionaryWaarde van eigenschap
De waarden voor de record die moeten worden ingevoegd.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de Values verzameling kunt herhalen. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de ListViewInsertEventArgs klasse.
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
Opmerkingen
Gebruik de Values eigenschap om toegang te krijgen tot de waarden van de velden voor de record die u wilt invoegen. U kunt bijvoorbeeld de waarden van de record valideren of coderen voordat deze in de gegevensbron wordt ingevoegd.
De Values eigenschap retourneert een OrderedDictionary object dat de IOrderedDictionary interface implementeert. Het OrderedDictionary object bevat DictionaryEntry objecten die de velden van de record vertegenwoordigen. Gebruik de Keys eigenschap van het OrderedDictionary object om toegang te krijgen tot de veldnamen. Gebruik de Values eigenschap om toegang te krijgen tot de veldwaarden.
Note
Als snelkoppeling kunt u de indexeerfunctie van het OrderedDictionary object gebruiken om rechtstreeks toegang te krijgen tot de veldwaarden. Het voordeel van het gebruik van de indexeerfunctie is dat veldwaarden rechtstreeks worden geretourneerd. Besturingselementen voor gegevensbronnen die afhankelijk zijn van de veldvolgorde (zoals AccessDataSource) hebben alleen toegang tot veldwaarden per index.