IFormCollection.Item[String] Eigenschaft

Definition

Namespace:

Microsoft.AspNetCore.Http

Assembly:

Microsoft.AspNetCore.Http.Features.dll

Paket:

Microsoft.AspNetCore.App.Ref v8.0.0

Quelle:

IFormCollection.cs

Ruft den Wert mit dem angegebenen Schlüssel ab.

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

Parameter

key

String

Der Schlüssel des abzurufenden Werts.

Eigenschaftswert

StringValues

Das Element mit dem angegebenen Schlüssel oder StringValues.Empty , wenn der Schlüssel nicht vorhanden ist.

Ausnahmen

ArgumentNullException

key ist NULL.

InvalidOperationException

falscher Inhaltstyp.

Hinweise

IFormCollection hat einen anderen Indexervertrag als IDictionary<TKey,TValue>, da er für fehlende Einträge zurückgegeben StringValues.Empty wird, anstatt eine Ausnahme auszugeben.

Dieser Indexer kann nur für POST-Anforderungen verwendet werden. Andernfalls wird eine Ausnahme vom Typ InvalidOperationException ausgelöst.

Das Aufrufen dieser Eigenschaft kann zu einer Threadauslastung führen, da eine asynchrone Implementierung umschlossen wird. Die HttpRequest.ReadFormAsync(CancellationToken) -Methode kann das Formular abrufen, ohne zu blockieren. Weitere Informationen finden Sie unter https://aka.ms/aspnet/forms-async.