WwwFormUrlDecoder WwwFormUrlDecoder WwwFormUrlDecoder WwwFormUrlDecoder Class

Creates and initializes a new instance of the WwwFormUrlDecoder class.

public : WwwFormUrlDecoder(PlatForm::String query)public WwwFormUrlDecoder(String query)Public Sub New(query As String)// You can use this method in JavaScript.

Remarks

The query string must start with a '?' character.

Any '&' character encountered represents a new name-value pair. If there is a '=' character present in the string, the substring to the left of the '=' character is the name and the right substring is the value.

The constructor doesn't do much validation on the string beyond verifying that it isn't null or the wrong type. If your input doesn't correctly represent a query string that starts with '?' and contains name-value pairs separated by '&', the collection contents are empty or invalid, and calls to GetFirstValueByName won't have the expected result.

URL-encoded characters are not decoded, they are simply included in the name-value pairs.

See Also

IWwwFormUrlDecoderEntryIWwwFormUrlDecoderEntryIWwwFormUrlDecoderEntryIWwwFormUrlDecoderEntry

Gets the element at the specified index in the read-only list.

This member is not implemented in C++T this[int index] { get; }ReadOnly Property Item(index As Integer) As TT this[int index] { get; }

Gets the number of the name-value pairs in the current URL query string.

public : unsigned int Size { get; }This member is not implemented in C#This member is not implemented in VB.Net// You can use this property in JavaScript.

Remarks

Name-value pairs are represented by IWwwFormUrlDecoderEntry objects.

Gets an iterator that represents the first name-value pair in the current URL query string.

public : IIterator<IWwwFormUrlDecoderEntry> First()This member is not implemented in C#This member is not implemented in VB.Net// You can use this method in JavaScript.

Gets the name-value pair at the specified index in the current URL query string.

public : IWwwFormUrlDecoderEntry GetAt(unsigned int index)This member is not implemented in C#This member is not implemented in VB.Net// You can use this method in JavaScript.

Returns an enumerator that iterates through the collection.

This member is not implemented in C++IEnumerator<T> GetEnumerator()Function GetEnumerator As IEnumerator(Of T)IEnumerator<T> GetEnumerator()

Gets the first name-value pair that has the specified name, as obtained from the constructing Uniform Resource Identifier (URI) query string.

public : PlatForm::String GetFirstValueByName(PlatForm::String name)public string GetFirstValueByName(String name)Public Function GetFirstValueByName(name As String) As string// You can use this method in JavaScript.

Remarks

This method throws an exception (an error for JavaScript) if the value specified as name doesn't exist in the WwwFormUrlDecoder collection. For .NET code, this is typed as System.ArgumentException. You'll probably want to call GetFirstValueByName within a try-catch block so you have a chance to handle the exception.

What to do with duplicate names in a query string from a GET request is not specified by any Internet standard. A common practice is to process the first value and ignore the subsequent duplicates. The GetFirstValueByName method provides that behavior. It also provides the de-facto "index by string" behavior, which is typically what you want when you're processing a query string. Your app is expecting certain names to be present on the query string, and wants to retrieve the associated value.

Gets name-value pairs starting at the specified index in the current URL query string.

public : unsigned int GetMany(unsigned int startIndex, IWwwFormUrlDecoderEntry[] items)This member is not implemented in C#This member is not implemented in VB.Net// You can use this method in JavaScript.

Gets a value indicating whether the specified IWwwFormUrlDecoderEntry is at the specified index in the current URL query string.

public : PlatForm::Boolean IndexOf(IWwwFormUrlDecoderEntry value, unsigned int index)This member is not implemented in C#This member is not implemented in VB.Net// You can use this method in JavaScript.