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.IOrderedDictionaryPublic 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), могут обращаться к значениям полей только по индексу.
