Marshal.PtrToStringAnsi Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- Quelle:
- Marshal.cs
- 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);[System.Security.SecurityCritical]
public static string PtrToStringAnsi (IntPtr ptr);public static string? PtrToStringAnsi (IntPtr ptr);public static string PtrToStringAnsi (IntPtr ptr);[<System.Security.SecurityCritical>]
static member PtrToStringAnsi : nativeint -> stringstatic member PtrToStringAnsi : nativeint -> stringPublic Shared Function PtrToStringAnsi (ptr As IntPtr) As StringParameter
- ptr
-
IntPtr
nativeint
Die Adresse des ersten Zeichens der nicht verwalteten Zeichenfolge.
Gibt zurück
Eine verwaltete Zeichenfolge, die eine Kopie der nicht verwalteten Zeichenfolge enthält. Wenn ptrnullist, gibt die Methode eine NULL-Zeichenfolge zurück.
- Attribute
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
Gilt für:
PtrToStringAnsi(IntPtr, Int32)
- Quelle:
- Marshal.cs
- Quelle:
- Marshal.cs
- 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);[System.Security.SecurityCritical]
public static string PtrToStringAnsi (IntPtr ptr, int len);public static string PtrToStringAnsi (IntPtr ptr, int len);[<System.Security.SecurityCritical>]
static member PtrToStringAnsi : nativeint * int -> stringstatic member PtrToStringAnsi : nativeint * int -> stringPublic Shared Function PtrToStringAnsi (ptr As IntPtr, len As Integer) As StringParameter
- ptr
-
IntPtr
nativeint
Die Adresse des ersten Zeichens der nicht verwalteten Zeichenfolge.
- len
- Int32
Die Byteanzahl der zu kopierenden Eingabezeichenfolge.
Gibt zurück
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.
- Attribute
Ausnahmen
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.
