HttpUtility.ParseQueryString Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.HttpUtility.dll

Analiza una cadena de consulta en una NameValueCollection.

Sobrecargas

ParseQueryString(String)	Analiza una cadena de consulta en un elemento NameValueCollection mediante codificación UTF8.
ParseQueryString(String, Encoding)	Analiza una cadena de consulta en una NameValueCollection usando el Encoding especificado.

ParseQueryString(String)

Source:

HttpUtility.cs

Analiza una cadena de consulta en un elemento NameValueCollection mediante codificación UTF8.

public:
 static System::Collections::Specialized::NameValueCollection ^ ParseQueryString(System::String ^ query);

public static System.Collections.Specialized.NameValueCollection ParseQueryString (string query);

static member ParseQueryString : string -> System.Collections.Specialized.NameValueCollection

Public Shared Function ParseQueryString (query As String) As NameValueCollection

Parámetros

query

String

Cadena de consulta que se va a analizar.

Devoluciones

NameValueCollection

Un elemento NameValueCollection de valores y parámetros de consulta.

Excepciones

ArgumentNullException

query es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método ParseQueryString. Varias apariciones de la misma variable de cadena de consulta se consolidan en una entrada del devuelto NameValueCollection.

using System;
using System.Web;

class Program
{
    static void Main()
    {
        // Parse the URL and get the query string
        var url = "https://www.microsoft.com?name=John&age=30&location=USA";
        var parsedUrl = url.Split('?')[1];

        // The ParseQueryString method will parse the query string and return a NameValueCollection
        var paramsCollection = HttpUtility.ParseQueryString(parsedUrl);

        // The foreach loop will iterate over the params collection and print the key and value for each param
        foreach (var key in paramsCollection.AllKeys)
        {
            Console.WriteLine($"Key: {key} => Value: {paramsCollection[key]}");
        }
    }
}

// The example displays the following output:
// Key: name => Value: John
// Key: age => Value: 30
// Key: location => Value: USA

Imports System.Collections.Specialized
Imports System.Web

Public Class Sample
    Public Shared Sub Main()
        ' Parse the URL and get the query string
        Dim url As String = "https://www.microsoft.com?name=John&age=30&location=USA"
        Dim parsedUrl As String = url.Split("?")(1)

        ' The ParseQueryString method will parse the query string and return a NameValueCollection
        Dim paramsCollection As NameValueCollection = HttpUtility.ParseQueryString(parsedUrl)

        ' The For Each loop will iterate over the params collection and print the key and value for each param
        For Each key As String In paramsCollection.AllKeys
            Console.WriteLine($"Key: {key} => Value: {paramsCollection(key)}")
        Next
    End Sub
End Class

' The example displays the following output:
' Key: name => Value: John
' Key: age => Value: 30
' Key: location => Value: USA

Comentarios

El ParseQueryString método usa UTF8 el formato para analizar la cadena de consulta En el devuelto NameValueCollection, los caracteres codificados en url se descodifican y varias apariciones del mismo parámetro de cadena de consulta se enumeran como una sola entrada con una coma que separa cada valor.

Importante

El ParseQueryString método usa cadenas de consulta que pueden contener la entrada del usuario, que es una amenaza de seguridad potencial. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.

Consulte también

• Encoding

ParseQueryString(String, Encoding)

Source:

HttpUtility.cs

Analiza una cadena de consulta en una NameValueCollection usando el Encoding especificado.

public:
 static System::Collections::Specialized::NameValueCollection ^ ParseQueryString(System::String ^ query, System::Text::Encoding ^ encoding);

public static System.Collections.Specialized.NameValueCollection ParseQueryString (string query, System.Text.Encoding encoding);

static member ParseQueryString : string * System.Text.Encoding -> System.Collections.Specialized.NameValueCollection

Public Shared Function ParseQueryString (query As String, encoding As Encoding) As NameValueCollection

Parámetros

query

String

Cadena de consulta que se va a analizar.

encoding

Encoding

Objeto Encoding que se va a usar.

Devoluciones

NameValueCollection

Un elemento NameValueCollection de valores y parámetros de consulta.

Excepciones

ArgumentNullException

query es null.

O bien

encoding es null.

Comentarios

En el objeto devuelto NameValueCollection, los caracteres codificados por url se descodifican y varias apariciones del mismo parámetro de cadena de consulta se enumeran como una sola entrada con una coma que separa cada valor.

Importante

El ParseQueryString método usa cadenas de consulta que pueden contener la entrada del usuario, que es una amenaza de seguridad potencial. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.

Consulte también

• Encoding