StringBuilderExtensionPolyfillExtensionAppendUrlEncoded Method

Appends the content of a String as URL-encoded character sequence to the end of a StringBuilder.

Definition

Namespace: FolkerKinzel.Strings
Assembly: FolkerKinzel.Strings (in FolkerKinzel.Strings.dll) Version: 9.4.0+10a7d4d71aa960998e32ac0ac6c4fcbe4164c917

C#

public static StringBuilder AppendUrlEncoded(
	this StringBuilder builder,
	string? value
)

VB

<ExtensionAttribute>
Public Shared Function AppendUrlEncoded ( 
	builder As StringBuilder,
	value As String
) As StringBuilder

C++

public:
[ExtensionAttribute]
static StringBuilder^ AppendUrlEncoded(
	StringBuilder^ builder, 
	String^ value
)

F#

[<ExtensionAttribute>]
static member AppendUrlEncoded : 
        builder : StringBuilder * 
        value : string -> StringBuilder

Parameters

builder StringBuilder: The StringBuilder to which the characters are appended.
value String: The String containing the characters to encode and append, or null.

Return Value

StringBuilder
A reference to builder after the append operation has completed.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type StringBuilder. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Remarks

The method replaces all characters in value except unreserved RFC 3986 characters into their hexadecimal representation. All Unicode characters are converted to UTF-8 format before being escaped. This method assumes that there are no escape sequences in value.

Exceptions

ArgumentNullException	builder is null.
ArgumentOutOfRangeException	Increasing the capacity of builder would exceed MaxCapacity.