Marshal.PtrToStringAnsi Methode

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Ordnet eine verwaltete String zu und kopiert alle oder einen Teil einer nicht verwalteten ANSI -Zeichenfolge (unter Windows) oder UTF-8 (auf Unix) darin.

Überlädt

PtrToStringAnsi(IntPtr)	Kopiert alle Zeichen bis zum ersten NULL-Zeichen aus einer nicht verwalteten ANSI- oder UTF-8-Zeichenfolge in eine verwaltete Stringund erweitert jedes Zeichen auf UTF-16.
PtrToStringAnsi(IntPtr, Int32)	Weist eine verwaltete Stringzu, kopiert eine angegebene Anzahl von Zeichen aus einer nicht verwalteten ANSI- oder UTF-8-Zeichenfolge in die Zeichenfolge und erweitert jedes Zeichen auf UTF-16.

PtrToStringAnsi(IntPtr)

Quelle:

Marshal.cs

Kopiert alle Zeichen bis zum ersten NULL-Zeichen aus einer nicht verwalteten ANSI- oder UTF-8-Zeichenfolge in eine verwaltete Stringund erweitert jedes Zeichen auf 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

Parameter

ptr

IntPtr

nativeint

Die Adresse des ersten Zeichens der nicht verwalteten Zeichenfolge.

Gibt zurück

String

Eine verwaltete Zeichenfolge, die eine Kopie der nicht verwalteten Zeichenfolge enthält. Wenn ptrnullist, gibt die Methode eine NULL-Zeichenfolge zurück.

Beispiele

Im folgenden Beispiel wird die PtrToStringAnsi-Methode verwendet, um eine verwaltete Zeichenfolge aus einem nicht verwalteten char Array zu erstellen.

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

Hinweise

PtrToStringAnsi eignet sich für das benutzerdefinierte Marshalling oder beim Mischen von verwaltetem und nicht verwaltetem Code. Da diese Methode eine Kopie des Inhalts der nicht verwalteten Zeichenfolge erstellt, müssen Sie die ursprüngliche Zeichenfolge entsprechend freigeben. Diese Methode stellt die entgegengesetzte Funktionalität der methoden Marshal.StringToCoTaskMemAnsi und Marshal.StringToHGlobalAnsi bereit.

Weitere Informationen

• StringToCoTaskMemAnsi(String)
• StringToHGlobalAnsi(String)

PtrToStringAnsi(IntPtr, Int32)

Quelle:

Marshal.cs

Weist eine verwaltete Stringzu, kopiert eine angegebene Anzahl von Zeichen aus einer nicht verwalteten ANSI- oder UTF-8-Zeichenfolge in die Zeichenfolge und erweitert jedes Zeichen auf 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

Parameter

ptr

IntPtr

nativeint

Die Adresse des ersten Zeichens der nicht verwalteten Zeichenfolge.

len

Int32

Die Byteanzahl der zu kopierenden Eingabezeichenfolge.

Gibt zurück

String

Eine verwaltete Zeichenfolge, die eine Kopie der nativen Zeichenfolge enthält, wenn der Wert des ptr-Parameters nicht nullist; andernfalls gibt diese Methode nullzurück.

Ausnahmen

ArgumentException

len ist kleiner als Null.

Beispiele

Im folgenden Beispiel wird die PtrToStringAnsi-Methode verwendet, um eine verwaltete Zeichenfolge aus einem nicht verwaltetenchar Array zu erstellen.

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

Hinweise

PtrToStringAnsi eignet sich für das benutzerdefinierte Marshalling oder beim Mischen von verwaltetem und nicht verwaltetem Code. Da diese Methode eine Kopie des Inhalts der nicht verwalteten Zeichenfolge erstellt, müssen Sie die ursprüngliche Zeichenfolge entsprechend freigeben. Diese Methode stellt die entgegengesetzte Funktionalität der methoden Marshal.StringToCoTaskMemAnsi und Marshal.StringToHGlobalAnsi bereit.

Weitere Informationen

• StringToCoTaskMemAnsi(String)
• StringToHGlobalAnsi(String)