Share via


MetadataBuilder.ReserveUserString(Int32) Methode

Definition

Reserviert im Benutzerzeichenfolgenheap Speicherplatz für eine Zeichenfolge der angegebenen Länge.

public:
 System::Reflection::Metadata::ReservedBlob<System::Reflection::Metadata::UserStringHandle> ReserveUserString(int length);
public System.Reflection.Metadata.ReservedBlob<System.Reflection.Metadata.UserStringHandle> ReserveUserString (int length);
member this.ReserveUserString : int -> System.Reflection.Metadata.ReservedBlob<System.Reflection.Metadata.UserStringHandle>
Public Function ReserveUserString (length As Integer) As ReservedBlob(Of UserStringHandle)

Parameter

length
Int32

Die Anzahl der zu reservierenden Zeichen.

Gibt zurück

Ein Handle für die reservierte Benutzerzeichenfolge und ein Blob, welches das gesamte Benutzerzeichenfolgenblob (einschließlich Länge und Terminalzeichen) darstellt. Das Handle kann in LoadString(UserStringHandle) verwendet werden. Verwenden Sie WriteUserString(String), um den Blobinhalt aufzufüllen.

Ausnahmen

Der verbleibende Speicherplatz auf dem Heap ist zu klein, um die Zeichenfolge zu passen.

length ist ein negativer Wert.

Gilt für: