Marshal.PtrToStringAuto Metoda

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices

Zestaw:

System.Runtime.InteropServices.dll

Przydziela zarządzany i String kopiuje do niego wszystkie lub części niezarządzanego ciągu.

Przeciążenia

PtrToStringAuto(IntPtr)	Przydziela zarządzany i String kopiuje wszystkie znaki do pierwszego znaku null z ciągu przechowywanego w niezarządzanej pamięci.
PtrToStringAuto(IntPtr, Int32)	Przydziela zarządzaną String i kopiuje do niego określoną liczbę znaków z ciągu przechowywanego w niezarządzanej pamięci.

PtrToStringAuto(IntPtr)

Źródło:

Marshal.Unix.cs

Przydziela zarządzany i String kopiuje wszystkie znaki do pierwszego znaku null z ciągu przechowywanego w niezarządzanej pamięci.

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

public static string? PtrToStringAuto (IntPtr ptr);

static member PtrToStringAuto : nativeint -> string

Public Shared Function PtrToStringAuto (ptr As IntPtr) As String

Parametry

ptr

IntPtr

nativeint

W przypadku platform Unicode adres pierwszego znaku Unicode.

-lub-

W przypadku platform ANSI adres pierwszego znaku ANSI.

Zwraca

String

Ciąg zarządzany, który zawiera kopię niezarządzanego ciągu, jeśli wartość parametru ptr nie nulljest ; w przeciwnym razie ta metoda zwraca wartość null.

Uwagi

Jeśli bieżąca platforma to Unicode, każdy znak ANSI jest rozszerzony na znak Unicode, a ta metoda wywołuje PtrToStringUnimetodę . W przeciwnym razie ta metoda wywołuje PtrToStringAnsimetodę .

PtrToStringAuto jest przydatne w przypadku niestandardowego marshalingu lub podczas mieszania zarządzanego i niezarządzanych kodu. Ponieważ ta metoda tworzy kopię zawartości niezarządzanego ciągu, należy zwolnić oryginalny ciąg odpowiednio. PtrToStringAuto udostępnia przeciwną funkcjonalność Marshal.StringToCoTaskMemAuto metod i Marshal.StringToHGlobalAuto .

Zobacz też

• StringToCoTaskMemAuto(String)
• StringToHGlobalAuto(String)
• PtrToStringUni(IntPtr, Int32)
• PtrToStringAnsi(IntPtr)

PtrToStringAuto(IntPtr, Int32)

Źródło:

Marshal.Unix.cs

Przydziela zarządzaną String i kopiuje do niego określoną liczbę znaków z ciągu przechowywanego w niezarządzanej pamięci.

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

public static string? PtrToStringAuto (IntPtr ptr, int len);

static member PtrToStringAuto : nativeint * int -> string

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

Parametry

ptr

IntPtr

nativeint

W przypadku platform Unicode adres pierwszego znaku Unicode.

-lub-

W przypadku platform ANSI adres pierwszego znaku ANSI.

len

Int32

Liczba znaków do skopiowania.

Zwraca

String

Ciąg zarządzany, który zawiera kopię ciągu natywnego, jeśli wartość ptr parametru nie nulljest ; w przeciwnym razie ta metoda zwraca wartość null.

Wyjątki

ArgumentException

Parametr len ma wartość niższą niż zero.

Uwagi

Na platformach Unicode ta metoda wywołuje metodę PtrToStringUni; na platformach ANSI wywołuje metodę PtrToStringAnsi. Przed wywołaniami tych metod nie są wykonywane żadne przekształcenia.

PtrToStringAuto jest przydatne w przypadku niestandardowego marshalingu lub podczas mieszania zarządzanego i niezarządzanych kodu. Ponieważ ta metoda tworzy kopię zawartości niezarządzanego ciągu, należy zwolnić oryginalny ciąg odpowiednio. PtrToStringAuto udostępnia przeciwną funkcjonalność i Marshal.StringToCoTaskMemAutoMarshal.StringToHGlobalAuto.

Zobacz też

• StringToCoTaskMemAuto(String)
• StringToHGlobalAuto(String)
• PtrToStringUni(IntPtr, Int32)
• PtrToStringAnsi(IntPtr)