HttpUtility.ParseQueryString Metódus

Definíció

Névtér:

System.Web

Szerelvények:

netstandard.dll, System.Web.HttpUtility.dll

Lekérdezési sztring elemzése egy NameValueCollection.

Túlterhelések

Name	Description
ParseQueryString(String)	Egy lekérdezési sztringet kódolással NameValueCollectionUTF8 elemez.
ParseQueryString(String, Encoding)	Egy lekérdezési sztring elemzése a NameValueCollection megadott Encodinghasználatával.

ParseQueryString(String)

Forrás:

HttpUtility.cs

Egy lekérdezési sztringet kódolással NameValueCollectionUTF8 elemez.

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

Paraméterek

query

String

Az elemezni kívánt lekérdezési sztring.

Válaszok

NameValueCollection

A NameValueCollection lekérdezési paraméterek és értékek.

Kivételek

ArgumentNullException

query az null.

Példák

Az alábbi példakód bemutatja a ParseQueryString metódus használatát. Ugyanannak a lekérdezési sztringváltozónak több előfordulása is konszolidálva lesz a visszaadott NameValueCollectionváltozó egyik bejegyzésében.

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

Megjegyzések

A ParseQueryString metódus formátummal UTF8 elemzi a lekérdezési sztringet A visszaadott NameValueCollection, URL-kódolt karakterek dekódolva vannak, és ugyanazon lekérdezési sztringparaméter több előfordulása egyetlen bejegyzésként van felsorolva, vesszővel elválasztva az egyes értékeket.

Important

A ParseQueryString metódus olyan lekérdezési sztringeket használ, amelyek felhasználói bemenetet tartalmazhatnak, ami potenciális biztonsági fenyegetés. Alapértelmezés szerint ASP.NET weblapok ellenőrzik, hogy a felhasználói bevitel nem tartalmaz-e szkript- vagy HTML-elemeket. További információ: Szkript kihasználása – áttekintés.

Lásd még

• Encoding

ParseQueryString(String, Encoding)

Forrás:

HttpUtility.cs

Egy lekérdezési sztring elemzése a NameValueCollection megadott Encodinghasználatával.

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

Paraméterek

query

String

Az elemezni kívánt lekérdezési sztring.

encoding

Encoding

A Encoding használni kívánt.

Válaszok

NameValueCollection

A NameValueCollection lekérdezési paraméterek és értékek.

Kivételek

ArgumentNullException

query az null.

-vagy-

encoding az null.

Megjegyzések

A visszaadott NameValueCollection, URL-kódolt karakterek dekódolva vannak, és ugyanazon lekérdezési sztringparaméter több előfordulása egyetlen bejegyzésként van felsorolva, az egyes értékeket vesszővel elválasztva.

Important

A ParseQueryString metódus olyan lekérdezési sztringeket használ, amelyek felhasználói bemenetet tartalmazhatnak, ami potenciális biztonsági fenyegetés. Alapértelmezés szerint ASP.NET weblapok ellenőrzik, hogy a felhasználói bevitel nem tartalmaz-e szkript- vagy HTML-elemeket. További információ: Szkript kihasználása – áttekintés.

Lásd még

• Encoding