Marshal.StringToHGlobalAuto(String) Metodo

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 -> nativeint

Public Shared Function StringToHGlobalAuto (s As String) As IntPtr

Parametri

Valori restituiti

Indirizzo, in memoria non gestita, in cui è stata copiata la stringa oppure 0 se s è null.

Attributi

SecurityCriticalAttribute

Eccezioni

Esempio

Nell'esempio seguente viene illustrato come convertire il contenuto di una classe gestita String in memoria non gestita e quindi eliminare la memoria non gestita al termine.

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;
}

Commenti

StringToHGlobalAuto è utile per il marshalling personalizzato o per l'uso durante la combinazione di codice gestito e non gestito. Poiché questo metodo alloca la memoria non gestita necessaria per una stringa, libera sempre la memoria chiamando FreeHGlobal. Questo metodo fornisce la funzionalità opposta di Marshal.PtrToStringAuto.

Questo metodo copia i caratteri Null incorporati e include un carattere Null di terminazione.

Vedi anche

• PtrToStringAuto(IntPtr, Int32)