IFormCollection.Item[String] Propiedad

Definición

Espacio de nombres:

Microsoft.AspNetCore.Http

Ensamblado:

Microsoft.AspNetCore.Http.Features.dll

Paquete:

Microsoft.AspNetCore.App.Ref v8.0.0

Source:

IFormCollection.cs

Obtiene el valor con la clave especificada.

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

Parámetros

key

String

Clave del valor que se va a obtener.

Valor de propiedad

StringValues

Elemento con la clave especificada o StringValues.Empty si la clave no está presente.

Excepciones

ArgumentNullException

key es NULL.

InvalidOperationException

tipo de contenido incorrecto.

Comentarios

IFormCollection tiene un contrato de indexador diferente a IDictionary<TKey,TValue>, ya que devolverá StringValues.Empty las entradas que faltan en lugar de iniciar una excepción.

Este indexador solo se puede usar en solicitudes POST. De lo contrario, se produce una excepción de tipo InvalidOperationException .

Invocar esta propiedad podría provocar el agotamiento de subprocesos, ya que está encapsulando una implementación asincrónica. El HttpRequest.ReadFormAsync(CancellationToken) método puede obtener el formulario sin bloqueo. Para obtener más información, vea https://aka.ms/aspnet/forms-async.