Marshal.PtrToStringAnsi Metodo

Definizione

Spazio dei nomi:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Alloca un String gestito e copia in essa una stringa ANSI (in Windows) o UTF-8 (on Unix) non gestita.

Overload

PtrToStringAnsi(IntPtr)	Copia tutti i caratteri fino al primo carattere Null da una stringa ANSI o UTF-8 non gestita a un Stringgestito e estende ogni carattere a UTF-16.
PtrToStringAnsi(IntPtr, Int32)	Alloca un Stringgestito, copia un numero specificato di caratteri da una stringa ANSI o UTF-8 non gestita e estende ogni carattere a UTF-16.

PtrToStringAnsi(IntPtr)

Origine:

Marshal.cs

Copia tutti i caratteri fino al primo carattere Null da una stringa ANSI o UTF-8 non gestita a un Stringgestito e estende ogni carattere a UTF-16.

C#

public static string? PtrToStringAnsi (IntPtr ptr);

Parametri

ptr

IntPtr

Indirizzo del primo carattere della stringa non gestita.

Restituisce

String

Stringa gestita che contiene una copia della stringa non gestita. Se ptr è null, il metodo restituisce una stringa Null.

Esempio

Nell'esempio seguente viene usato il metodo PtrToStringAnsi per creare una stringa gestita da una matrice di char non gestita.

C++

using namespace System;
using namespace System::Runtime::InteropServices;

void main()
{
    // Create an unmanaged c string.
    const char * myString = "Hello managed world (from the unmanaged world)!";
    
    // Convert the c string to a managed String.
    String ^ myManagedString = Marshal::PtrToStringAnsi((IntPtr) (char *) myString);
    
    // Display the string to the console.
    Console::WriteLine(myManagedString);
}

Commenti

PtrToStringAnsi è utile per il marshalling personalizzato o quando si combina codice gestito e non gestito. Poiché questo metodo crea una copia del contenuto della stringa non gestita, è necessario liberare la stringa originale in base alle esigenze. Questo metodo fornisce la funzionalità opposta dei metodi Marshal.StringToCoTaskMemAnsi e Marshal.StringToHGlobalAnsi.

Vedi anche

• StringToCoTaskMemAnsi(String)
• StringToHGlobalAnsi(String)

PtrToStringAnsi(IntPtr, Int32)

Origine:

Marshal.cs

Alloca un Stringgestito, copia un numero specificato di caratteri da una stringa ANSI o UTF-8 non gestita e estende ogni carattere a UTF-16.

C#

public static string PtrToStringAnsi (IntPtr ptr, int len);

Parametri

ptr

IntPtr

Indirizzo del primo carattere della stringa non gestita.

len

Int32

Numero di byte della stringa di input da copiare.

Restituisce

String

Stringa gestita che contiene una copia della stringa nativa se il valore del parametro ptr non è null; in caso contrario, questo metodo restituisce null.

Eccezioni

ArgumentException

len è minore di zero.

Esempio

Nell'esempio seguente viene usato il metodo PtrToStringAnsi per creare una stringa gestita da una matrice dichar non gestita.

C++

using namespace System;
using namespace System::Runtime::InteropServices;



void main()
{
    // Create an unmanaged c string.
    const char * myString = "Hello managed world (from the unmanaged world)!";

    // Convert the c string to a managed String.
    String ^ myManagedString = Marshal::PtrToStringAnsi((IntPtr) (char *) myString);

    // Display the string to the console.
    Console::WriteLine(myManagedString);
}

Commenti

PtrToStringAnsi è utile per il marshalling personalizzato o quando si combina codice gestito e non gestito. Poiché questo metodo crea una copia del contenuto della stringa non gestita, è necessario liberare la stringa originale in base alle esigenze. Questo metodo fornisce la funzionalità opposta dei metodi Marshal.StringToCoTaskMemAnsi e Marshal.StringToHGlobalAnsi.

Vedi anche

• StringToCoTaskMemAnsi(String)
• StringToHGlobalAnsi(String)