IFormCollection.Item[String] Propriedade

Definição

Namespace:

Microsoft.AspNetCore.Http

Assembly:

Microsoft.AspNetCore.Http.Features.dll

Pacote:

Microsoft.AspNetCore.App.Ref v9.0.0

Obtém o valor com a chave especificada.

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

Parâmetros

key

String

A chave do valor a ser obtido.

Valor da propriedade

StringValues

O elemento com a chave especificada ou StringValues.Empty se a chave não estiver presente.

Exceções

ArgumentNullException

key é nulo.

InvalidOperationException

tipo de conteúdo incorreto.

Comentários

IFormCollection tem um contrato de indexador diferente de IDictionary<TKey,TValue>, pois ele retornará StringValues.Empty para entradas ausentes em vez de gerar uma Exceção.

Esse indexador só pode ser usado em solicitações POST. Caso contrário, uma exceção do tipo InvalidOperationException é gerada.

Invocar essa propriedade pode resultar em esgotamento de thread, pois ela está encapsulando uma implementação assíncrona. O HttpRequest.ReadFormAsync(CancellationToken) método pode obter o formulário sem bloqueio. Para obter mais informações, consulte https://aka.ms/aspnet/forms-async.