HttpUtility.ParseQueryString Metoda

Definicja

Przestrzeń nazw:

System.Web

Zestaw:

System.Web.HttpUtility.dll

Analizuje ciąg zapytania w obiekcie NameValueCollection.

Przeciążenia

ParseQueryString(String)	Analizuje ciąg zapytania przy NameValueCollection użyciu UTF8 kodowania.
ParseQueryString(String, Encoding)	Analizuje ciąg zapytania przy NameValueCollection użyciu określonego Encodingelementu .

ParseQueryString(String)

Źródło:

HttpUtility.cs

Analizuje ciąg zapytania przy NameValueCollection użyciu UTF8 kodowania.

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

Ciąg zapytania do analizy.

Zwraca

NameValueCollection

A NameValueCollection parametrów i wartości zapytania.

Wyjątki

ArgumentNullException

query to null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać ParseQueryString metody . Wiele wystąpień tej samej zmiennej ciągu zapytania jest konsolidowanych w jednym wpisie zwróconego NameValueCollectionelementu .

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

Uwagi

Metoda ParseQueryString używa UTF8 formatu do analizowania ciągu zapytania W zwracanych NameValueCollectionznakach zakodowanych w adresie URL są dekodowane, a wiele wystąpień tego samego parametru ciągu zapytania jest wyświetlanych jako pojedynczy wpis z przecinkiem oddzielającym każdą wartość.

Ważne

Metoda ParseQueryString używa ciągów zapytania, które mogą zawierać dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web weryfikują, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Omówienie luk w zabezpieczeniach skryptów.

Zobacz też

• Encoding

ParseQueryString(String, Encoding)

Źródło:

HttpUtility.cs

Analizuje ciąg zapytania przy NameValueCollection użyciu określonego Encodingelementu .

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

Ciąg zapytania do analizy.

encoding

Encoding

Do Encoding użycia.

Zwraca

NameValueCollection

A NameValueCollection parametrów i wartości zapytania.

Wyjątki

ArgumentNullException

query to null.

-lub-

encoding to null.

Uwagi

W zwracanych NameValueCollectionznakach zakodowanych w adresie URL są dekodowane, a wiele wystąpień tego samego parametru ciągu zapytania jest wyświetlanych jako pojedynczy wpis z przecinkiem oddzielającym każdą wartość.

Ważne

Metoda ParseQueryString używa ciągów zapytania, które mogą zawierać dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web weryfikują, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Omówienie luk w zabezpieczeniach skryptów.

Zobacz też

• Encoding