IFormCollection.Item[String] Propriété

Définition

Espace de noms:

Microsoft.AspNetCore.Http

Assembly:

Microsoft.AspNetCore.Http.Features.dll

Paquet:

Microsoft.AspNetCore.App.Ref v8.0.0

Obtient la valeur avec la clé spécifiée.

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

Paramètres

key

String

Clé de la valeur à obtenir.

Valeur de propriété

StringValues

Élément avec la clé spécifiée, ou StringValues.Empty si la clé n’est pas présente.

Exceptions

ArgumentNullException

key a la valeur null.

InvalidOperationException

type de contenu incorrect.

Remarques

IFormCollection a un contrat d’indexeur différent de IDictionary<TKey,TValue>, car il retourne StringValues.Empty pour les entrées manquantes au lieu de lever une exception.

Cet indexeur ne peut être utilisé que sur les requêtes POST. Sinon, une exception de type InvalidOperationException est levée.

L’appel de cette propriété peut entraîner un épuisement des threads, car il encapsule une implémentation asynchrone. La HttpRequest.ReadFormAsync(CancellationToken) méthode peut obtenir le formulaire sans bloquer. Pour plus d’informations, consultez https://aka.ms/aspnet/forms-async.