HttpUtility.ParseQueryString Methode

Definition

Namespace:

System.Web

Assemblys:

System.Web.dll, System.Web.Services.dll

Analysiert eine Abfragezeichenfolge in eine NameValueCollection.

Überlädt

Name	Beschreibung
ParseQueryString(String)	Analysiert eine Abfragezeichenfolge in eine NameValueCollection using-Codierung UTF8 .
ParseQueryString(String, Encoding)	Analysiert eine Abfragezeichenfolge mithilfe NameValueCollection des angegebenen Encoding.

ParseQueryString(String)

Analysiert eine Abfragezeichenfolge in eine NameValueCollection using-Codierung 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

Parameter

query

String

Die zu analysierende Abfragezeichenfolge.

Gibt zurück

NameValueCollection

A NameValueCollection of query parameters and values.

Ausnahmen

ArgumentNullException

query ist null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der ParseQueryString Methode veranschaulicht. Mehrere Vorkommen derselben Abfragezeichenfolgenvariable werden in einem Eintrag der zurückgegebenen NameValueCollectionVariablen konsolidiert.

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

Hinweise

Die ParseQueryString Methode verwendet UTF8 das Format, um die Abfragezeichenfolge in der zurückgegebenen NameValueCollection, URL-codierten Zeichen zu analysieren, und mehrere Vorkommen desselben Abfragezeichenfolgenparameters werden als einzelner Eintrag mit einem Komma aufgelistet, das jeden Wert trennt.

Important

Die ParseQueryString Methode verwendet Abfragezeichenfolgen, die möglicherweise Benutzereingaben enthalten, was eine potenzielle Sicherheitsrisiken darstellt. Standardmäßig überprüfen ASP.NET Webseiten, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Script Exploits Overview.

Weitere Informationen

• Encoding

ParseQueryString(String, Encoding)

Analysiert eine Abfragezeichenfolge mithilfe NameValueCollection des angegebenen 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

Parameter

query

String

Die zu analysierende Abfragezeichenfolge.

encoding

Encoding

Die Encoding zu verwendende.

Gibt zurück

NameValueCollection

A NameValueCollection of query parameters and values.

Ausnahmen

ArgumentNullException

query ist null.

-oder-

encoding ist null.

Hinweise

In den zurückgegebenen NameValueCollection, URL-codierten Zeichen werden decodiert, und mehrere Vorkommen desselben Abfragezeichenfolgenparameters werden als einzelner Eintrag mit einem Komma aufgelistet, das jeden Wert trennt.

Important

Die ParseQueryString Methode verwendet Abfragezeichenfolgen, die möglicherweise Benutzereingaben enthalten, was eine potenzielle Sicherheitsrisiken darstellt. Standardmäßig überprüfen ASP.NET Webseiten, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Script Exploits Overview.

Weitere Informationen

• Encoding