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 dosyanın 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 örnek, yönetilen String bir sınıfın içeriğini yönetilmeyen belleğe dönüştürmeyi ve bittiğinde yönetilmeyen belleği atmayı gösterir.

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 yararlı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 tam tersini Marshal.PtrToStringAutosağlar.

Bu yöntem, katıştırılmış null karakterleri kopyalar ve sonlandırıcı bir null karakter içerir.

Ayrıca bkz.

• PtrToStringAuto(IntPtr, Int32)