NameValueCollection.Item[] Свойство

Определение

Пространство имен:

System.Collections.Specialized

Сборка:

System.Collections.Specialized.dll

Получает или задает указанную запись коллекции NameValueCollection.

Перегрузки

Item[Int32]	Получает запись по указанному индексу в коллекции NameValueCollection.
Item[String]	Получает или задает запись с указанным ключом в коллекции NameValueCollection.

Item[Int32]

Исходный код:

NameValueCollection.cs

Получает запись по указанному индексу в коллекции NameValueCollection.

public:
 property System::String ^ default[int] { System::String ^ get(int index); };

public string? this[int index] { get; }

member this.Item(int) : string

Default Public ReadOnly Property Item(index As Integer) As String

Параметры

index

Int32

Индекс (с нуля) записи, расположение которой требуется определить в коллекции.

Значение свойства

String

Объект String, который содержит список значений с разделителями-запятыми по указанному индексу в коллекции.

Исключения

ArgumentOutOfRangeException

index находится вне допустимого диапазона индексов для коллекции.

Комментарии

Это свойство предоставляет доступ к указанному элементу коллекции при использовании следующего синтаксиса: myCollection[index].

Не удается задать это свойство. Чтобы задать значение по указанному индексу, используйте .Item[GetKey(index)]

Язык C# использует этот ключевое слово для определения индексаторов вместо реализации Item[] свойства . Visual Basic реализует Item[] как свойство по умолчанию, которое предоставляет те же функции индексирования.

Получение значений по указанному индексу является операцией O(n), где n — количество значений.

См. также раздел

• Get
• Выполнение строковых операций, не зависящих от языка и региональных параметров

Item[String]

Исходный код:

NameValueCollection.cs

Получает или задает запись с указанным ключом в коллекции NameValueCollection.

public:
 property System::String ^ default[System::String ^] { System::String ^ get(System::String ^ name); void set(System::String ^ name, System::String ^ value); };

public string? this[string? name] { get; set; }

member this.Item(string) : string with get, set

Default Public Property Item(name As String) As String

Параметры

name

String

Ключ String для записи, которую требуется найти. Значением ключа может быть null.

Значение свойства

String

Объект String, который содержит список значений с разделителями-запятыми, связанных с указанным ключом, если он найден; в противном случае — значение null.

Исключения

NotSupportedException

Коллекция доступна только для чтения, а в операции предпринимается попытка изменить коллекцию.

Комментарии

Это свойство предоставляет доступ к указанному элементу коллекции при использовании следующего синтаксиса: myCollection[name].

Если указанный ключ уже существует в коллекции, задание этого свойства перезаписывает существующий список значений указанным значением. Чтобы добавить новое значение в существующий список значений, используйте Add метод .

Если указанный ключ не существует в коллекции, при задании этого свойства создается новая запись с использованием указанного ключа и указанного значения.

Внимание!

Это свойство возвращается null в следующих случаях: 1) если указанный ключ не найден; и 2) значение , если указанный ключ найден и связанное с ним значение равно null. Это свойство не различает два варианта.

Язык C# использует этот ключевое слово для определения индексаторов вместо реализации Item[] свойства . Visual Basic реализует Item[] как свойство по умолчанию, которое предоставляет те же функции индексирования.

Получение или задание значений, связанных с указанным ключом, является операцией O(n), где n — количество значений.

См. также раздел

• Get
• Выполнение строковых операций, не зависящих от языка и региональных параметров