Marshal.StringToHGlobalAuto(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Копирует содержимое управляемой в неуправляемую String память, преобразуя в формат ANSI при необходимости.
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 IntPtrПараметры
- s
- String
Управляемая строка для копирования.
Возвращаемое значение
nativeint
Адрес, в неуправляемой памяти, в место копирования строки или 0, если s .null
- Атрибуты
Исключения
Доступно недостаточно памяти.
Примеры
В следующем примере показано, как преобразовать содержимое управляемого String класса в неуправляемую память, а затем удалить неуправляемую память при завершении.
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;
}
Комментарии
StringToHGlobalAuto полезно для пользовательского маршалинга или для использования при сочетании управляемого и неуправляемого кода. Так как этот метод выделяет неуправляемую память, необходимую для строки, всегда освобождает память путем вызова FreeHGlobal. Этот метод предоставляет противоположные функциональные Marshal.PtrToStringAutoвозможности.
Этот метод копирует внедренные символы NULL и включает в себя завершающий символ NULL.
