Marshal.StringToCoTaskMemUTF8(String) Metode

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

System.Runtime.InteropServices.dll

Sumber:

Marshal.cs

Menyalin konten yang dikelola String ke blok memori yang dialokasikan dari alokator tugas COM yang tidak dikelola.

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

Parameter

s

String

String terkelola yang akan disalin.

Mengembalikan

IntPtr

nativeint

Bilangan bulat yang mewakili penunjuk ke blok memori yang dialokasikan untuk string, atau 0 jika s adalah null.

Pengecualian

ArgumentOutOfRangeException

Parameter s melebihi panjang maksimum yang diizinkan oleh sistem operasi.

OutOfMemoryException

Tidak tersedia cukup memori.

Keterangan

StringToCoTaskMemUTF8 berguna untuk marshaling kustom atau untuk digunakan saat mencampur kode terkelola dan tidak terkelola. Karena metode ini mengalokasikan memori tidak terkelola yang diperlukan untuk string termasuk terminator null, selalu bebaskan memori dengan memanggil Marshal.FreeCoTaskMem. Metode ini menyediakan fungsionalitas yang berlawanan dari Marshal.PtrToStringUTF8. Karakter string disalin sebagai karakter UTF-8.

Lihat juga

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