IFormCollection.Item[String] Свойство

Определение

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

Microsoft.AspNetCore.Http

Сборка:

Microsoft.AspNetCore.Http.Features.dll

Пакет:

Microsoft.AspNetCore.App.Ref v9.0.0

Возвращает значение с указанным ключом.

public:
 property Microsoft::Extensions::Primitives::StringValues default[System::String ^] { Microsoft::Extensions::Primitives::StringValues get(System::String ^ key); };

public Microsoft.Extensions.Primitives.StringValues this[string key] { get; }

member this.Item(string) : Microsoft.Extensions.Primitives.StringValues

Default Public ReadOnly Property Item(key As String) As StringValues

Параметры

key

String

Ключ значения, которое необходимо получить.

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

StringValues

Элемент с указанным ключом или StringValues.Empty значение , если ключ отсутствует.

Исключения

ArgumentNullException

Параметр key имеет значение null.

InvalidOperationException

неправильный тип содержимого.

Комментарии

IFormCollection имеет контракт индексатора, отличный от IDictionary<TKey,TValue>, так как он будет возвращать StringValues.Empty для отсутствующих записей, а не создавать исключение.

Этот индексатор можно использовать только для запросов POST. В противном случае возникает исключение типа InvalidOperationException .

Вызов этого свойства может привести к исчерпанию потока, так как он упаковывает асинхронную реализацию. Метод HttpRequest.ReadFormAsync(CancellationToken) может получить форму без блокировки. Для получения дополнительной информации см. https://aka.ms/aspnet/forms-async.