HttpUtility.ParseQueryString Метод

Определение

Пространство имен:

System.Web

Сборка:

System.Web.HttpUtility.dll

Преобразует строку запроса в NameValueCollection.

Перегрузки

ParseQueryString(String)	Преобразует строку запроса в NameValueCollection с использованием кодировки UTF8.
ParseQueryString(String, Encoding)	Преобразует строку запроса в NameValueCollection с использованием указанного Encoding.

ParseQueryString(String)

Исходный код:

HttpUtility.cs

Преобразует строку запроса в NameValueCollection с использованием кодировки 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

Параметры

query

String

Преобразуемая строка запроса.

Возвращаемое значение

NameValueCollection

NameValueCollection параметров запроса и значений.

Исключения

ArgumentNullException

query имеет значение null.

Примеры

В следующем примере кода показано, как использовать метод ParseQueryString. Несколько вхождений одной и той же переменной строки запроса объединяются в одну запись возвращаемого 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

Комментарии

Метод ParseQueryString использует UTF8 формат для синтаксического анализа строки запроса. В возвращаемом NameValueCollectionкодировании символы URL-адреса декодируются, а несколько вхождений одного и того же параметра строки запроса перечисляются в виде одной записи с запятыми, разделяющими каждое значение.

Важно!

Метод ParseQueryString использует строки запроса, которые могут содержать введенные пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.

См. также раздел

• Encoding

ParseQueryString(String, Encoding)

Исходный код:

HttpUtility.cs

Преобразует строку запроса в NameValueCollection с использованием указанного 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

Параметры

query

String

Преобразуемая строка запроса.

encoding

Encoding

Используемый Encoding.

Возвращаемое значение

NameValueCollection

NameValueCollection параметров запроса и значений.

Исключения

ArgumentNullException

query имеет значение null.

-или-

encoding имеет значение null.

Комментарии

В возвращенном NameValueCollectionкодировании URL-адреса декодируются, а несколько вхождений одного и того же параметра строки запроса перечисляются как одна запись с запятой, разделяющей каждое значение.

Важно!

Метод ParseQueryString использует строки запроса, которые могут содержать введенные пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.

См. также раздел

• Encoding