HttpUtility.ParseQueryString Método

Definição

Namespace:

System.Web

Assembly:

System.Web.HttpUtility.dll

Analisa uma cadeia de caracteres de consulta em uma NameValueCollection.

Sobrecargas

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

ParseQueryString(String)

Origem:

HttpUtility.cs

Analisa uma cadeia de caracteres de consulta em um NameValueCollection usando codificação 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

A cadeia de caracteres de consulta a ser analisada.

Retornos

NameValueCollection

Um NameValueCollection de valores e parâmetros de consulta.

Exceções

ArgumentNullException

query é null.

Exemplos

O exemplo de código a seguir demonstra como usar o ParseQueryString método . Várias ocorrências da mesma variável de cadeia de caracteres de consulta são consolidadas em uma entrada do retornado 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

Comentários

O ParseQueryString método usa formato para analisar a cadeia de caracteres de consulta Nos caracteres retornados NameValueCollection, os caracteres UTF8 codificados em URL são decodificados e várias ocorrências do mesmo parâmetro de cadeia de caracteres de consulta são listadas como uma única entrada com uma vírgula separando cada valor.

Importante

O ParseQueryString método usa cadeias de caracteres de consulta que podem conter a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.

Confira também

• Encoding

ParseQueryString(String, Encoding)

Origem:

HttpUtility.cs

Analisa uma cadeia de caracteres de consulta em um NameValueCollection usando o 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

A cadeia de caracteres de consulta a ser analisada.

encoding

Encoding

O Encoding a ser usado.

Retornos

NameValueCollection

Um NameValueCollection de valores e parâmetros de consulta.

Exceções

ArgumentNullException

query é null.

- ou -

encoding é null.

Comentários

No retornado NameValueCollection, os caracteres codificados em URL são decodificados e várias ocorrências do mesmo parâmetro de cadeia de caracteres de consulta são listadas como uma única entrada com uma vírgula separando cada valor.

Importante

O ParseQueryString método usa cadeias de caracteres de consulta que podem conter a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.

Confira também

• Encoding