IFormCollection.Item[String] Właściwość

Definicja

Przestrzeń nazw:

Microsoft.AspNetCore.Http

Zestaw:

Microsoft.AspNetCore.Http.Features.dll

Pakiet:

Microsoft.AspNetCore.App.Ref v8.0.0

Pobiera wartość z określonym kluczem.

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

Parametry

key

String

Klucz wartości do pobrania.

Wartość właściwości

StringValues

Element z określonym kluczem lub StringValues.Empty jeśli klucz nie jest obecny.

Wyjątki

ArgumentNullException

klucz ma wartość null.

InvalidOperationException

niepoprawny typ zawartości.

Uwagi

IFormCollection ma inny kontrakt indeksatora niż IDictionary<TKey,TValue>, ponieważ zwróci StringValues.Empty brakujące wpisy, zamiast zgłaszać wyjątek.

Ten indeksator może być używany tylko dla żądań POST. W przeciwnym razie zgłaszany jest wyjątek typu InvalidOperationException .

Wywołanie tej właściwości może spowodować wyczerpanie wątków, ponieważ opakowuje implementację asynchroniczną. Metoda HttpRequest.ReadFormAsync(CancellationToken) może pobrać formularz bez blokowania. Aby uzyskać więcej informacji, zobacz https://aka.ms/aspnet/forms-async.