HttpUtility.ParseQueryString Método

Definição

Espaço de Nomes:

System.Web

Assemblagens:

System.Web.dll, System.Web.Services.dll

Analisa uma cadeia de consulta num NameValueCollection.

Sobrecargas

Name	Description
ParseQueryString(String)	Analisa uma cadeia de consulta num NameValueCollection usando UTF8 codificação.
ParseQueryString(String, Encoding)	Analisa uma cadeia de consulta em um NameValueCollection usando o especificado Encoding.

ParseQueryString(String)

Analisa uma cadeia de consulta num NameValueCollection usando UTF8 codificação.

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

A cadeia de consulta a analisar.

Devoluções

NameValueCollection

A NameValueCollection dos parâmetros e valores da consulta.

Exceções

ArgumentNullException

query é null.

Exemplos

O exemplo de código seguinte demonstra como usar o ParseQueryString método. Múltiplas ocorrências da mesma variável de sequência de consulta são consolidadas numa única entrada do retorno 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

Observações

O ParseQueryString método utiliza UTF8 formato para analisar a cadeia de consulta No retorno NameValueCollection, os caracteres codificados por URL são decodificados e múltiplas ocorrências do mesmo parâmetro de cadeia de consulta são listadas como uma única entrada com uma vírgula a separar cada valor.

Importante

O ParseQueryString método utiliza strings de consulta que podem conter entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.

Ver também

• Encoding

ParseQueryString(String, Encoding)

Analisa uma cadeia de consulta em um NameValueCollection usando o especificado Encoding.

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

A cadeia de consulta a analisar.

encoding

Encoding

O Encoding para usar.

Devoluções

NameValueCollection

A NameValueCollection dos parâmetros e valores da consulta.

Exceções

ArgumentNullException

query é null.

-ou-

encoding é null.

Observações

No retorno NameValueCollection, os caracteres codificados por URL são decodificados e múltiplas ocorrências do mesmo parâmetro de string de consulta são listadas como uma única entrada com uma vírgula a separar cada valor.

Importante

O ParseQueryString método utiliza strings de consulta que podem conter entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.

Ver também

• Encoding