HttpUtility.ParseQueryString Methode

Definition

Analysiert eine Abfragezeichenfolge in eine NameValueCollection.

Überlädt

ParseQueryString(String)

Liest eine Abfragezeichenfolge mithilfe der UTF8-Codierung in eine NameValueCollection ein.

ParseQueryString(String, Encoding)

Zerlegt eine Abfragezeichenfolge mithilfe der angegebenen Encoding in eine NameValueCollection.

ParseQueryString(String)

Source:
HttpUtility.cs
Source:
HttpUtility.cs
Source:
HttpUtility.cs

Liest eine Abfragezeichenfolge mithilfe der UTF8-Codierung in eine NameValueCollection ein.

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 zerlegende Abfragezeichenfolge.

Gibt zurück

Eine NameValueCollection von Abfrageparametern und -werten.

Ausnahmen

query ist null.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die ParseQueryString-Methode verwenden. Mehrere Vorkommen derselben Abfragezeichenfolgenvariable werden in einem Eintrag des zurückgegebenen NameValueCollectionkonsolidiert.


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 zu analysieren. In der zurückgegebenen NameValueCollectionwerden URL-codierte Zeichen decodiert, und mehrere Vorkommen desselben Abfragezeichenfolgenparameters werden als einzelner Eintrag mit einem Komma aufgeführt, das jeden Wert trennt.

Wichtig

Die ParseQueryString -Methode verwendet Abfragezeichenfolgen, die möglicherweise Benutzereingaben enthalten, was eine potenzielle Sicherheitsgefährdung darstellt. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

Weitere Informationen

Gilt für:

ParseQueryString(String, Encoding)

Source:
HttpUtility.cs
Source:
HttpUtility.cs
Source:
HttpUtility.cs

Zerlegt eine Abfragezeichenfolge mithilfe der angegebenen Encoding in eine NameValueCollection.

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 zerlegende Abfragezeichenfolge.

encoding
Encoding

Der zu verwendende Encoding.

Gibt zurück

Eine NameValueCollection von Abfrageparametern und -werten.

Ausnahmen

query ist null.

- oder -

encoding ist null.

Hinweise

In der zurückgegebenen NameValueCollectionwerden URL-codierte Zeichen decodiert, und mehrere Vorkommen desselben Abfragezeichenfolgenparameters werden als einzelner Eintrag mit einem Komma aufgeführt, das jeden Wert trennt.

Wichtig

Die ParseQueryString -Methode verwendet Abfragezeichenfolgen, die möglicherweise Benutzereingaben enthalten, was eine potenzielle Sicherheitsgefährdung darstellt. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

Weitere Informationen

Gilt für: