WwwFormUrlDecoder Clase

Definición

Espacio de nombres:

Windows.Foundation

Analiza una cadena de consulta de dirección URL y expone los resultados como un vector de solo lectura (lista) de pares nombre-valor de la cadena de consulta.

public ref class WwwFormUrlDecoder sealed : IIterable<IWwwFormUrlDecoderEntry ^>, IVectorView<IWwwFormUrlDecoderEntry ^>

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Foundation.IWwwFormUrlDecoderRuntimeClassFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class WwwFormUrlDecoder final : IIterable<IWwwFormUrlDecoderEntry>, IVectorView<IWwwFormUrlDecoderEntry>

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Foundation.IWwwFormUrlDecoderRuntimeClassFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class WwwFormUrlDecoder : IEnumerable<IWwwFormUrlDecoderEntry>, IReadOnlyList<IWwwFormUrlDecoderEntry>

function WwwFormUrlDecoder(query)

Public NotInheritable Class WwwFormUrlDecoder
Implements IEnumerable(Of IWwwFormUrlDecoderEntry), IReadOnlyList(Of IWwwFormUrlDecoderEntry)

Herencia

Object Platform::Object IInspectable WwwFormUrlDecoder

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IIterable<T> IEnumerable<T> IIterable<IWwwFormUrlDecoderEntry> IEnumerable<IWwwFormUrlDecoderEntry> IVectorView<IWwwFormUrlDecoderEntry> IReadOnlyList<IWwwFormUrlDecoderEntry>

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Use la clase WwwFormUrlDecoder para analizar una cadena de consulta en pares nombre-valor, en función del número y la ubicación de los símbolos "&" y "=". Cada par nombre-valor se representa mediante un objeto IWwwFormUrlDecoderEntry , que tiene una propiedad Name y una propiedad Value (ambas cadenas).

Use GetFirstValueByName para buscar un parámetro de cadena de consulta con nombre específico. Todos los lenguajes pueden usar este método. Normalmente, usaría GetFirstValueByName en lugar de GetAt porque el orden de los elementos de una cadena de consulta normalmente no es importante, mientras que el nombre del parámetro es el identificador importante de las partes de una consulta. O bien, si no está seguro de qué nombres existen en la cadena de consulta, puede enumerar en la colección WwwFormUrlDecoder completa.

La propiedad Uri.QueryParsed devuelve un wwwFormUrlDecoder completo basado en una instancia de URI . Por lo tanto, si usa extensiones de componentes de Visual C++ (C++/CX) o código javaScript, y ya tiene una instancia de URI , no tendrá que construir un nuevo objeto WwwFormUrlDecoder, la instancia de URI ya tiene una. Puede construir un wwwFormUrlDecoder si tiene una cadena que representa una dirección URL o su componente de cadena de consulta de otros orígenes, como desde una API Windows.Web.Http .

Nota:

Esta colección es un vector en lugar de un mapa en caso de que el orden original tenga ningún significado para una implementación y también porque es legal que el mismo nombre aparezca en la cadena de consulta dos veces, mientras que no es legal que los mapas tengan claves duplicadas.

Listas de miembros de la colección

Para el uso de .NET, WwwFormUrlDecoder tiene las API proyectadas de un IReadOnlyList genérico con una restricción IWwwFormUrlDecoderEntry . Las API que están disponibles para cada idioma se indican en las listas de miembros.

Para JavaScript, WwwFormUrlDecoder tiene los miembros que se muestran en las listas de miembros. Además, WwwFormUrlDecoder admite una propiedad length , los miembros de Array.prototype y el uso de un índice para acceder a los elementos.

Uso de .NET

El código .NET no puede usar la clase Windows.Foundation.Uri (en su lugar, se usa System.Uri ). Pero el código .NET puede y debe usar WwwFormUrlDecoder. El uso de WwwFormUrlDecoder es más sencillo y menos propenso a errores que la división de cadenas en caracteres "&" y "=". Esto se complica debido a la codificación. Para usar WwwFormUrlDecoder, llame al constructor WwwFormUrlDecoder y pase el valor query de System.Uri. Esto inicializa un nuevo objeto WwwFormUrlDecoder. A continuación, use GetFirstValueByName para buscar un parámetro de cadena de consulta con nombre específico. O bien, si no sabe qué va a estar en la cadena de consulta, enumere la colección para determinar los parámetros de cadena de consulta que están disponibles.

Use la interfaz IWwwFormUrlDecoderEntry para el tipo de los elementos de la colección (es decir, cómo indexOf escribe los elementos). No use la clase WwwFormUrlDecoderEntry , no está disponible para el uso de .NET.

WwwFormUrlDecoder también tiene las API proyectadas de un IReadOnlyList genérico con una restricción IWwwFormUrlDecoderEntry , pero estas API no se usan normalmente.

Nota

System.Web.HttpUtility.ParseQueryStringno está disponible para .NET para Windows Runtime aplicación. WwwFormUrlDecoder es el reemplazo recomendado para él.

Enumeración de la colección en C# o Microsoft Visual Basic

WwwFormUrlDecoder es enumerable, por lo que puede usar sintaxis específica del lenguaje, como foreach en C# para enumerar los elementos de la colección. El compilador realiza la conversión de tipos automáticamente y no es necesario convertir a IEnumerable<IWwwFormUrlDecoderEntry> explícitamente. Si necesita convertir explícitamente, por ejemplo, si desea llamar a GetEnumerator, convierta a IEnumerable<T> con una restricción IWwwFormUrlDecoderEntry .

Constructores

WwwFormUrlDecoder(String)

Crea e inicializa una nueva instancia de la clase WwwFormUrlDecoder .

Propiedades

Size	Obtiene el número de pares nombre-valor en la cadena de consulta de dirección URL actual.

Métodos

First()	Obtiene un iterador que representa el par nombre-valor en la cadena de consulta de dirección URL actual.
GetAt(UInt32)	Obtiene el par nombre-valor en el índice especificado en la cadena de consulta de dirección URL actual.
GetFirstValueByName(String)	Obtiene el primer par nombre-valor que tiene el nombre especificado, tal como se obtiene de la cadena de consulta identificador uniforme de recursos (URI).
GetMany(UInt32, IWwwFormUrlDecoderEntry[])	Obtiene pares nombre-valor a partir del índice especificado en la cadena de consulta de dirección URL actual.
IndexOf(IWwwFormUrlDecoderEntry, UInt32)	Obtiene un valor que indica si el valor de IWwwFormUrlDecoderEntry especificado está en el índice especificado en la cadena de consulta de dirección URL actual.

Consulte también

• IWwwFormUrlDecoderEntry
• QueryParsed