HttpUtility.ParseQueryString Метод

Определение

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

System.Web

Сборки:

netstandard.dll, System.Web.HttpUtility.dll

Анализирует строку запроса в объект NameValueCollection.

Перегрузки

Имя	Описание
ParseQueryString(String)	Анализирует строку запроса в кодировке NameValueCollection с помощью UTF8 кодирования.
ParseQueryString(String, Encoding)	Анализирует строку запроса в указанный NameValueCollectionEncodingпараметр.

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

Important

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

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

• Encoding

ParseQueryString(String, Encoding)

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

HttpUtility.cs

Анализирует строку запроса в указанный NameValueCollectionEncodingпараметр.

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

Important

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

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

• Encoding