Marshal.StringToHGlobalAuto(String) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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);public static IntPtr StringToHGlobalAuto (string s);[System.Security.SecurityCritical]
public static IntPtr StringToHGlobalAuto (string s);static member StringToHGlobalAuto : string -> nativeint[<System.Security.SecurityCritical>]
static member StringToHGlobalAuto : string -> nativeintPublic Shared Function StringToHGlobalAuto (s As String) As IntPtrParametreler
- s
- String
Kopyalanacak yönetilen dize.
Döndürülenler
nativeint
Yönetilmeyen bellekteki adres, dizenin kopyalandığı yere veya ise snull0.
- Öznitelikler
Özel durumlar
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.
