HttpUtility.ParseQueryString Metoda

Definice

Parsuje řetězec dotazu na .NameValueCollection

Přetížení

ParseQueryString(String)

Parsuje řetězec dotazu na NameValueCollection kódování using UTF8 .

ParseQueryString(String, Encoding)

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

ParseQueryString(String)

Zdroj:
HttpUtility.cs
Zdroj:
HttpUtility.cs
Zdroj:
HttpUtility.cs

Parsuje řetězec dotazu na NameValueCollection kódování using UTF8 .

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

Parametry

query
String

Řetězec dotazu, který se má analyzovat.

Návraty

A NameValueCollection parametrů a hodnot dotazu.

Výjimky

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

Poznámky

Metoda ParseQueryString používá UTF8 formát k parsování řetězce dotazu Ve vráceném NameValueCollectionobjektu se znaky zakódované v adrese URL dekódují a několik výskytů stejného parametru řetězce dotazu je uvedeno jako jedna položka s čárkou, která odděluje každou hodnotu.

Důležité

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

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ParseQueryString(String, Encoding)

Zdroj:
HttpUtility.cs
Zdroj:
HttpUtility.cs
Zdroj:
HttpUtility.cs

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

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

Parametry

query
String

Řetězec dotazu, který se má analyzovat.

encoding
Encoding

Hodnota, Encoding která se má použít.

Návraty

A NameValueCollection parametrů a hodnot dotazu.

Výjimky

query je null.

-nebo-

encoding je null.

Poznámky

Ve vrácené NameValueCollectionsadě se znaky zakódované v adrese URL dekódují a několik výskytů stejného parametru řetězce dotazu je uvedeno jako jedna položka s čárkami, které oddělují každou hodnotu.

Důležité

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

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1