Marshal.PtrToStringUTF8 Método

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Sobrecargas

PtrToStringUTF8(IntPtr)	Aloca uma String gerenciada e copia para ela todos os caracteres até o primeiro caractere nulo de uma cadeia de caracteres UTF-8 não gerenciada.
PtrToStringUTF8(IntPtr, Int32)	Aloca uma String gerenciada e copia para ela um número especificado de bytes de uma cadeia de caracteres UTF-8 não gerenciada.

PtrToStringUTF8(IntPtr)

Origem:

Marshal.cs

Aloca uma String gerenciada e copia para ela todos os caracteres até o primeiro caractere nulo de uma cadeia de caracteres UTF-8 não gerenciada.

public:
 static System::String ^ PtrToStringUTF8(IntPtr ptr);

public static string? PtrToStringUTF8 (IntPtr ptr);

static member PtrToStringUTF8 : nativeint -> string

Public Shared Function PtrToStringUTF8 (ptr As IntPtr) As String

Parâmetros

ptr

IntPtr

nativeint

O endereço do primeiro caractere da cadeia de caracteres não gerenciada.

Retornos

String

Uma cadeia de caracteres gerenciada que mantém uma cópia da cadeia de caracteres não gerenciada, se o valor do ptr parâmetro não é null; caso contrário, esse método retornará null.

Comentários

PtrToStringUTF8 é útil para marshaling personalizado ou para uso ao misturar código gerenciado e não gerenciado. Como esse método cria uma cópia do conteúdo da cadeia de caracteres não gerenciada, você deve liberar a cadeia de caracteres original conforme apropriado. Esse método fornece a funcionalidade oposta dos Marshal.StringToCoTaskMemUTF8 métodos.

Confira também

• StringToCoTaskMemUTF8(String)

PtrToStringUTF8(IntPtr, Int32)

Origem:

Marshal.cs

Aloca uma String gerenciada e copia para ela um número especificado de bytes de uma cadeia de caracteres UTF-8 não gerenciada.

public:
 static System::String ^ PtrToStringUTF8(IntPtr ptr, int byteLen);

public static string PtrToStringUTF8 (IntPtr ptr, int byteLen);

static member PtrToStringUTF8 : nativeint * int -> string

Public Shared Function PtrToStringUTF8 (ptr As IntPtr, byteLen As Integer) As String

Parâmetros

ptr

IntPtr

nativeint

O endereço do primeiro caractere da cadeia de caracteres não gerenciada.

byteLen

Int32

O número de bytes a serem copiados.

Retornos

String

Uma cadeia de caracteres gerenciada que mantém uma cópia da cadeia de caracteres não gerenciada, se o valor do ptr parâmetro não é null; caso contrário, esse método retornará null.

Comentários

PtrToStringUTF8 é útil para marshaling personalizado ou ao misturar código gerenciado e não gerenciado. Como esse método cria uma cópia do conteúdo da cadeia de caracteres não gerenciada, você deve liberar a cadeia de caracteres original conforme apropriado. Esse método fornece a funcionalidade oposta dos Marshal.StringToCoTaskMemUTF8 métodos.

Confira também

• StringToCoTaskMemUTF8(String)