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.

public:
 static System::String ^ PtrToStringAnsi(IntPtr ptr);

public static string? PtrToStringAnsi (IntPtr ptr);

static member PtrToStringAnsi : nativeint -> string

Public Shared Function PtrToStringAnsi (ptr As IntPtr) As String

Parametri

ptr

IntPtr

nativeint

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.

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.

public:
 static System::String ^ PtrToStringAnsi(IntPtr ptr, int len);

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

static member PtrToStringAnsi : nativeint * int -> string

Public Shared Function PtrToStringAnsi (ptr As IntPtr, len As Integer) As String

Parametri

ptr

IntPtr

nativeint

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.

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)