StringBuilderExtensionAppendUrlEncoded(StringBuilder, ReadOnlySpan`1Char) Method

Appends the content of a read-only character span as URL-encoded string 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,
	ReadOnlySpan<char> value
)

VB

<ExtensionAttribute>
Public Shared Function AppendUrlEncoded ( 
	builder As StringBuilder,
	value As ReadOnlySpan(Of Char)
) As StringBuilder

C++

public:
[ExtensionAttribute]
static StringBuilder^ AppendUrlEncoded(
	StringBuilder^ builder, 
	ReadOnlySpan<wchar_t> value
)

F#

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

Parameters

builder StringBuilder: The StringBuilder to which the characters are appended.
value ReadOnlySpanChar: The read-only character span that provides the characters that have to be encoded and appended.

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.