BlobBuilder.WriteUserString(String) Method

Definition

Namespace:

System.Reflection.Metadata

Assembly:

System.Reflection.Metadata.dll

Package:

System.Reflection.Metadata v9.0.0-rc.2.24473.5

Source:

BlobBuilder.cs

Writes a string in User String (#US) heap format (see ECMA-335-II 24.2.4 #US and #Blob heaps).

public:
 void WriteUserString(System::String ^ value);

public void WriteUserString (string value);

member this.WriteUserString : string -> unit

Public Sub WriteUserString (value As String)

Parameters

value

String

Exceptions

InvalidOperationException

Builder is not writable, it has been linked with another one.

Remarks

The string is UTF16 encoded and prefixed by the its size in bytes.

This final byte holds the value 1 if and only if any UTF16 character within the string has any bit set in its top byte, or its low byte is any of the following: 0x01-0x08, 0x0E-0x1F, 0x27, 0x2D, 0x7F. Otherwise, it holds 0.

The 1 signifies Unicode characters that require handling beyond that normally provided for 8-bit encoding sets.