HttpUtility.ParseQueryString Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.HttpUtility.dll

Parsuje řetězec dotazu na NameValueCollection.

Přetížení

ParseQueryString(String)	Parsuje řetězec dotazu na NameValueCollection kódování pomocí UTF8 .
ParseQueryString(String, Encoding)	Parsuje řetězec dotazu na NameValueCollection řetězec pomocí zadaného Encodingřetězce .

ParseQueryString(String)

Zdroj:

HttpUtility.cs

Parsuje řetězec dotazu na NameValueCollection kódování pomocí 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

Parametry

query

String

Řetězec dotazu, který chcete analyzovat.

Návraty

NameValueCollection

A NameValueCollection parametrů a hodnot dotazu.

Výjimky

ArgumentNullException

query je null.

Příklady

Následující příklad kódu ukazuje, jak použít metodu ParseQueryString . Více výskytů stejné proměnné řetězce dotazu se konsoliduje v jedné položce vráceného NameValueCollectionobjektu .

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

Poznámky

Metoda ParseQueryString používá UTF8 formát k analýze řetězce dotazu Ve vráceném NameValueCollectionobjektu jsou dekódovány znaky zakódované adresou URL a několik výskytů stejného parametru řetězce dotazu je uvedeno jako jedna položka s čárkou oddělující každou hodnotu.

Důležité

Metoda ParseQueryString používá řetězce dotazu, které můžou obsahovat vstup uživatele, což je potenciální ohrožení zabezpečení. Ve výchozím nastavení ASP.NET webové stránky ověřují, že uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.

Viz také

• Encoding

ParseQueryString(String, Encoding)

Zdroj:

HttpUtility.cs

Parsuje řetězec dotazu na NameValueCollection řetězec pomocí zadaného Encodingřetězce .

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

Parametry

query

String

Řetězec dotazu, který chcete analyzovat.

encoding

Encoding

Příkaz Encoding , který se má použít.

Návraty

NameValueCollection

A NameValueCollection parametrů a hodnot dotazu.

Výjimky

ArgumentNullException

query je null.

-nebo-

encoding je null.

Poznámky

Ve vráceném NameValueCollectionobjektu jsou dekódovány znaky zakódované adresou URL a několik výskytů stejného parametru řetězce dotazu je uvedeno jako jedna položka s čárkou oddělující každou hodnotu.

Důležité

Metoda ParseQueryString používá řetězce dotazu, které můžou obsahovat vstup uživatele, což je potenciální ohrožení zabezpečení. Ve výchozím nastavení ASP.NET webové stránky ověřují, že uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.

Viz také

• Encoding