Marshal.StringToHGlobalAuto(String) Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.dll

Kaynak:

Marshal.Unix.cs

Yönetilen String bir bellek içeriğini yönetilmeyen belleğe kopyalar ve gerekirse ANSI biçimine dönüştürür.

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

public static IntPtr StringToHGlobalAuto (string? s);

static member StringToHGlobalAuto : string -> nativeint

Public Shared Function StringToHGlobalAuto (s As String) As IntPtr

Parametreler

s

String

Kopyalanacak yönetilen dize.

Döndürülenler

IntPtr

nativeint

Yönetilmeyen bellekteki adres, dizenin kopyalandığı yere veya ise snull0.

Özel durumlar

OutOfMemoryException

Kullanılabilir bellek yetersiz.

Örnekler

Aşağıdaki örnekte, yönetilen String bir sınıfın içeriğini yönetilmeyen belleğe dönüştürme ve bittiğinde yönetilmeyen belleğin atılması gösterilmektedir.

using namespace System;
using namespace System::Runtime::InteropServices;

int main()
{
    // Create a managed string.
    String^ managedString = "Hello unmanaged world (from the managed world).";

    // Marshal the managed string to unmanaged memory.
    char*  stringPointer = (char*) Marshal::StringToHGlobalAuto(managedString).ToPointer();

    // Pass the string to an unmanaged API.

    // Always free the unmanaged string.
    Marshal::FreeHGlobal(IntPtr(stringPointer));

    return 0;
}

Açıklamalar

StringToHGlobalAuto özel hazırlama için veya yönetilen ve yönetilmeyen kodu karıştırırken kullanmak için kullanışlıdır. Bu yöntem bir dize için gereken yönetilmeyen belleği ayırdığından, çağırarak FreeHGlobalbelleği her zaman boşaltın. Bu yöntem, işlevinin tersini Marshal.PtrToStringAutosağlar.

Bu yöntem eklenmiş null karakterleri kopyalar ve sonlandırıcı bir null karakter içerir.

Ayrıca bkz.

• PtrToStringAuto(IntPtr, Int32)