IFormCollection.Item[String] Vlastnost

Definice

Obor názvů:

Microsoft.AspNetCore.Http

Sestavení:

Microsoft.AspNetCore.Http.Features.dll

Balíček:

Microsoft.AspNetCore.App.Ref v8.0.0

Zdroj:

IFormCollection.cs

Získá hodnotu se zadaným klíčem.

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

Klíč hodnoty, kterou chcete získat

Hodnota vlastnosti

StringValues

Element se zadaným klíčem nebo StringValues.Empty pokud klíč neexistuje.

Výjimky

ArgumentNullException

klíč má hodnotu null.

InvalidOperationException

nesprávný typ obsahu.

Poznámky

IFormCollection má jiný kontrakt indexeru než IDictionary<TKey,TValue>, protože místo vyvolání výjimky vrátí StringValues.Empty chybějící položky.

Tento indexer se dá použít jenom u požadavků POST. V opačném případě dojde k výjimce typu InvalidOperationException .

Vyvolání této vlastnosti může vést k vyčerpání vláken, protože se tím zabalí asynchronní implementace. Metoda HttpRequest.ReadFormAsync(CancellationToken) může získat formulář bez blokování. Další informace naleznete v tématu https://aka.ms/aspnet/forms-async.