Marshal.StringToCoTaskMemUTF8(String) Метод

Определение

Пространство имен:

System.Runtime.InteropServices

Сборка:

System.Runtime.InteropServices.dll

Исходный код:

Marshal.cs

Копирует содержимое управляемого объекта типа String в блок памяти, выделенный из неуправляемого распределителя памяти для COM-задач.

public:
 static IntPtr StringToCoTaskMemUTF8(System::String ^ s);

public static IntPtr StringToCoTaskMemUTF8 (string? s);

static member StringToCoTaskMemUTF8 : string -> nativeint

Public Shared Function StringToCoTaskMemUTF8 (s As String) As IntPtr

Параметры

s

String

Копируемая управляемая строка.

Возвращаемое значение

IntPtr

nativeint

Целое число, представляющее указатель на блок памяти, выделенный для строки, или значение 0, если строка s имеет значение null.

Исключения

ArgumentOutOfRangeException

Параметр s превышает максимальную длину, разрешенную операционной системой.

OutOfMemoryException

Не хватает памяти.

Комментарии

StringToCoTaskMemUTF8 полезно для пользовательского маршалинга или для использования при смешивании управляемого и неуправляемого кода. Так как этот метод выделяет неуправляемую память, необходимую для строки, включая признак конца null, всегда освобождайте память, вызывая .Marshal.FreeCoTaskMem Этот метод предоставляет функциональность, противоположную Marshal.PtrToStringUTF8. Символы строки копируются в формате UTF-8.

См. также раздел

• FreeCoTaskMem(IntPtr)
• ZeroFreeCoTaskMemUTF8(IntPtr)
• PtrToStringUTF8(IntPtr, Int32)