Marshal.StringToHGlobalAnsi(String) Metodo

Definizione

Spazio dei nomi:

System.Runtime.InteropServices

Assembly:

netstandard.dll, System.Runtime.InteropServices.dll

Origine:

Marshal.cs

Copia il contenuto di un oggetto String gestito nella memoria non gestita, effettuando contemporaneamente la conversione nel formato ANSI.

public static IntPtr StringToHGlobalAnsi(string? s);

Parametri

s

String

Stringa gestita da copiare.

Restituisce

IntPtr

Indirizzo, nella memoria non gestita, in cui è stato copiato s, oppure 0 se s è null.

Eccezioni

OutOfMemoryException

La memoria disponibile è insufficiente.

ArgumentOutOfRangeException

Il parametro s supera la lunghezza massima consentita dal sistema operativo.

Esempio

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

using System;
using System.Runtime.InteropServices;
using System.Threading;

class MainFunction
{
    static void Main()
    {
        Console.WriteLine("\nStringToGlobalAnsi\n");

        // Create a managed string.
        String  managedString = "I am a managed String";
        Console.WriteLine("1) managedString = " + managedString);

        // Marshal the managed string to unmanaged memory.
        IntPtr stringPointer = (IntPtr)Marshal.StringToHGlobalAnsi(managedString);
        Console.WriteLine("2) stringPointer = {0}", stringPointer);

        // Get the string back from unmanaged memory.
        String RetrievedString = Marshal.PtrToStringAnsi(stringPointer);
        Console.WriteLine("3) Retrieved from unmanaged memory = " + RetrievedString);

        // Always free the unmanaged string.
        Marshal.FreeHGlobal(stringPointer);

        // IntPtr handle value is still the same:
        Console.WriteLine("4) stringPointer = " + stringPointer);

        // However, the data may be cleared after the memory is freed, depending on whether the memory allocated to stringPointer
        // has been reclaimed or not. Uncommenting the following line (Thread.Sleep(1000)) increases the likelihood of the memory being reclaimed.
        // Thread.Sleep(1000);
        String RetrievedString2 = Marshal.PtrToStringAnsi(stringPointer);
        Console.WriteLine("5) RetrievedString2 = " + RetrievedString2);
    }
}

Commenti

StringToHGlobalAnsi è utile per il marshalling personalizzato o quando si combina codice gestito e non gestito. Poiché questo metodo alloca la memoria non gestita necessaria per una stringa, libera sempre la memoria chiamando FreeHGlobal. StringToHGlobalAnsi fornisce la funzionalità opposta di Marshal.PtrToStringAnsi.

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

Si applica a

Vedi anche

• FreeCoTaskMem(IntPtr)
• PtrToStringAnsi(IntPtr)