Marshal.StringToCoTaskMemUTF8(String) Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.dll

Kaynak:

Marshal.cs

Yönetilen String bir dosyanın içeriğini yönetilmeyen COM görev ayırıcısından ayrılan bir bellek bloğuna kopyalar.

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

Parametreler

s

String

Kopyalanacak yönetilen dize.

Döndürülenler

IntPtr

nativeint

Dize için ayrılan bellek bloğunun işaretçisini temsil eden bir tamsayı veya ise snull0.

Özel durumlar

ArgumentOutOfRangeException

parametresi, s işletim sisteminin izin verdiği uzunluk üst sınırını aşıyor.

OutOfMemoryException

Kullanılabilir bellek yetersiz.

Açıklamalar

StringToCoTaskMemUTF8 özel hazırlama için veya yönetilen ve yönetilmeyen kodu karıştırırken kullanmak için yararlıdır. Bu yöntem null sonlandırıcı da dahil olmak üzere bir dize için gereken yönetilmeyen belleği ayırdığından, çağırarak Marshal.FreeCoTaskMembelleği her zaman serbest bırakın. Bu yöntem, işlevinin tam tersini Marshal.PtrToStringUTF8sağlar. Dizenin karakterleri UTF-8 karakterleri olarak kopyalanır.

Ayrıca bkz.

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