Compartilhar via


IFormCollection.Item[String] Propriedade

Definição

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

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

Exceções

key é nulo.

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.

Aplica-se a