Marshal.StringToHGlobalAuto(String) Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kodlar:

netstandard.dll, 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.

C#

public static IntPtr StringToHGlobalAuto(string? s);

Parametreler

s

String

Kopyalanacak yönetilen dize.

Döndürülenler

IntPtr

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.

C++

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.

Şunlara uygulanır

Ayrıca bkz.

• PtrToStringAuto(IntPtr, Int32)