IFormCollection.Item[String] Proprietà

Definizione

Spazio dei nomi:

Microsoft.AspNetCore.Http

Assembly:

Microsoft.AspNetCore.Http.Features.dll

Pacchetto:

Microsoft.AspNetCore.App.Ref v8.0.0

Origine:

IFormCollection.cs

Ottiene il valore con la chiave specificata.

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

Parametri

key

String

Chiave del valore da ottenere.

Valore della proprietà

StringValues

Elemento con la chiave specificata o StringValues.Empty se la chiave non è presente.

Eccezioni

ArgumentNullException

key è null.

InvalidOperationException

tipo di contenuto non corretto.

Commenti

IFormCollection ha un contratto indicizzatore diverso da IDictionary<TKey,TValue>, perché restituirà StringValues.Empty le voci mancanti anziché generare un'eccezione.

Questo indicizzatore può essere usato solo nelle richieste POST. In caso contrario, viene generata un'eccezione di tipo InvalidOperationException .

La chiamata di questa proprietà potrebbe comportare l'esaurimento dei thread perché esegue il wrapping di un'implementazione asincrona. Il HttpRequest.ReadFormAsync(CancellationToken) metodo può ottenere il form senza blocco. Per altre informazioni, vedere https://aka.ms/aspnet/forms-async.