Partilhar via


Marshal.StringToCoTaskMemUTF8(String) Método

Definição

Copia o conteúdo de um String gerenciado para um bloco de memória alocado do alocador de tarefas COM não gerenciado.

public:
 static IntPtr StringToCoTaskMemUTF8(System::String ^ s);
public static IntPtr StringToCoTaskMemUTF8 (string? s);
[System.Security.SecurityCritical]
public static IntPtr StringToCoTaskMemUTF8 (string s);
public static IntPtr StringToCoTaskMemUTF8 (string s);
static member StringToCoTaskMemUTF8 : string -> nativeint
[<System.Security.SecurityCritical>]
static member StringToCoTaskMemUTF8 : string -> nativeint
Public Shared Function StringToCoTaskMemUTF8 (s As String) As IntPtr

Parâmetros

s
String

Uma cadeia de caracteres gerenciada a ser copiada.

Retornos

IntPtr

nativeint

Um inteiro que representa um ponteiro para o bloco de memória alocado na cadeia de caracteres ou 0, se s for null.

Atributos

Exceções

O parâmetro s excede o tamanho máximo permitido pelo sistema operacional.

Memória insuficiente.

Comentários

StringToCoTaskMemUTF8 é útil para marshaling personalizado ou para uso ao misturar código gerenciado e não gerenciado. Como esse método aloca a memória não gerenciada necessária para uma cadeia de caracteres, incluindo um terminador nulo, sempre libere a memória chamando Marshal.FreeCoTaskMem. Esse método fornece a funcionalidade oposta de Marshal.PtrToStringUTF8. Os caracteres da cadeia de caracteres são copiados como caracteres UTF-8.

Aplica-se a

Confira também