HttpUtility.ParseQueryString Método

Definição

Analisa uma cadeia de caracteres de consulta em um NameValueCollection.

Sobrecargas

Nome Description
ParseQueryString(String)

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

ParseQueryString(String, Encoding)

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

ParseQueryString(String)

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

Um NameValueCollection dos parâmetros e valores de consulta.

Exceções

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 o formato para analisar a cadeia de caracteres de consulta No retornadoNameValueCollection, 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 ameaça à segurança em potencial. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos de script ou HTML. Para obter mais informações, consulte Visão geral das Explorações de Script.

Confira também

Aplica-se a

ParseQueryString(String, Encoding)

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

encoding
Encoding

O Encoding a ser usado.

Retornos

Um NameValueCollection dos parâmetros e valores de consulta.

Exceções

query é null.

-ou-

encoding é null.

Comentários

No retornado NameValueCollection, 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 ameaça à segurança em potencial. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos de script ou HTML. Para obter mais informações, consulte Visão geral das Explorações de Script.

Confira também

Aplica-se a