HttpUtility.ParseQueryString Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Parses a query string into a NameValueCollection.
Overloads
ParseQueryString(String) |
Parses a query string into a NameValueCollection using UTF8 encoding. |
ParseQueryString(String, Encoding) |
Parses a query string into a NameValueCollection using the specified Encoding. |
ParseQueryString(String)
- Source:
- HttpUtility.cs
- Source:
- HttpUtility.cs
- Source:
- HttpUtility.cs
Parses a query string into a NameValueCollection using UTF8 encoding.
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
Parameters
- query
- String
The query string to parse.
Returns
A NameValueCollection of query parameters and values.
Exceptions
query
is null
.
Examples
The following code example demonstrates how to use the ParseQueryString method. Multiple occurrences of the same query string variable are consolidated in one entry of the returned 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
Remarks
The ParseQueryString method uses UTF8 format to parse the query string In the returned NameValueCollection, URL encoded characters are decoded and multiple occurrences of the same query string parameter are listed as a single entry with a comma separating each value.
Important
The ParseQueryString method uses query strings that might contain user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.
See also
Applies to
ParseQueryString(String, Encoding)
- Source:
- HttpUtility.cs
- Source:
- HttpUtility.cs
- Source:
- HttpUtility.cs
Parses a query string into a NameValueCollection using the specified 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
Parameters
- query
- String
The query string to parse.
Returns
A NameValueCollection of query parameters and values.
Exceptions
Remarks
In the returned NameValueCollection, URL encoded characters are decoded and multiple occurrences of the same query string parameter are listed as a single entry with a comma separating each value.
Important
The ParseQueryString method uses query strings that might contain user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.
See also
Applies to
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: