HttpUtility.ParseQueryString Yöntem

Tanım

Ad Alanı:

System.Web

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Web.HttpUtility.dll

Sorgu dizesini içine NameValueCollectionayrıştırıyor.

Aşırı Yüklemeler

Name	Description
ParseQueryString(String)	Kullanarak NameValueCollection bir sorgu dizesini ayrıştırarak UTF8 kodlamaya dönüştürür.
ParseQueryString(String, Encoding)	Belirtilen NameValueCollectionkullanarak bir sorgu dizesini içinde Encoding ayrıştırıyor.

ParseQueryString(String)

Kaynak:

HttpUtility.cs

Kullanarak NameValueCollection bir sorgu dizesini ayrıştırarak UTF8 kodlamaya dönüştürür.

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

Parametreler

query

String

Ayrıştırmak için sorgu dizesi.

Döndürülenler

NameValueCollection

NameValueCollection Sorgu parametrelerinin ve değerlerinin bir örneği.

Özel durumlar

ArgumentNullException

query, null'e eşittir.

Örnekler

Aşağıdaki kod örneği, yönteminin ParseQueryString nasıl kullanılacağını gösterir. Aynı sorgu dizesi değişkeninin birden çok tekrarı, döndürülen NameValueCollectionöğesinin bir girdisinde birleştirilmiştir.

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

Açıklamalar

ParseQueryString yöntemi, sorgu dizesini ayrıştırmak için biçimi kullanır UTF8 Döndürülen NameValueCollectioniçinde, URL ile kodlanmış karakterlerin kodu çözülür ve aynı sorgu dizesi parametresinin birden çok tekrarı, her değeri birbirinden ayıran virgülle tek bir giriş olarak listelenir.

Important

yöntemi, ParseQueryString olası bir güvenlik tehdidi olan kullanıcı girişi içerebilecek sorgu dizelerini kullanır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz. Betik Açıklarına Genel Bakış.

Ayrıca bkz.

• Encoding

ParseQueryString(String, Encoding)

Kaynak:

HttpUtility.cs

Belirtilen NameValueCollectionkullanarak bir sorgu dizesini içinde Encoding ayrıştırıyor.

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

Parametreler

query

String

Ayrıştırmak için sorgu dizesi.

encoding

Encoding

Encoding Kullanılacak.

Döndürülenler

NameValueCollection

NameValueCollection Sorgu parametrelerinin ve değerlerinin bir örneği.

Özel durumlar

ArgumentNullException

query, null'e eşittir.

-veya-

encoding, null'e eşittir.

Açıklamalar

Döndürülen NameValueCollectioniçinde, URL kodlanmış karakterlerin kodu çözülür ve aynı sorgu dizesi parametresinin birden çok tekrarı, her değeri birbirinden ayıran virgülle tek bir giriş olarak listelenir.

Important

yöntemi, ParseQueryString olası bir güvenlik tehdidi olan kullanıcı girişi içerebilecek sorgu dizelerini kullanır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz. Betik Açıklarına Genel Bakış.

Ayrıca bkz.

• Encoding