ListViewInsertEventArgs.Values Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает значения для вставляемой записи.
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
Значение свойства
Значения для вставляемой записи.
Примеры
В следующем примере показано, как выполнить итерацию по Values коллекции. Этот пример кода является частью более крупного примера, предоставленного 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
Комментарии
Values Используйте свойство для доступа к значениям полей для вставки записи. Например, можно проверить или закодировать значения записи в формате HTML, прежде чем она будет вставлена в источник данных.
Свойство Values возвращает OrderedDictionary объект, реализующий IOrderedDictionary интерфейс. Объект OrderedDictionary содержит DictionaryEntry объекты, представляющие поля записи. Чтобы получить доступ к именам полей, используйте Keys свойство OrderedDictionary объекта. Чтобы получить доступ к значениям полей, используйте Values свойство.
Примечание
В качестве ярлыка OrderedDictionary можно использовать индексатор объекта для прямого доступа к значениям полей. Преимущество использования индексатора заключается в том, что он возвращает значения полей напрямую. Элементы управления источником данных, использующие порядок полей (например AccessDataSource), могут получать доступ к значениям полей только по индексу.