Marshal.PtrToStringUni メソッド

定義

名前空間:

System.Runtime.InteropServices

アセンブリ:

System.Runtime.InteropServices.dll

マネージド String を割り当て、アンマネージド Unicode 文字列のすべてまたは一部をコピーします。

オーバーロード

PtrToStringUni(IntPtr)	マネージド String を割り当て、アンマネージド Unicode 文字列から最初の null 文字まですべての文字をコピーします。
PtrToStringUni(IntPtr, Int32)	マネージド String を割り当て、アンマネージド Unicode 文字列から指定した数の文字をコピーします。

PtrToStringUni(IntPtr)

ソース:

Marshal.cs

マネージド String を割り当て、アンマネージド Unicode 文字列から最初の null 文字まですべての文字をコピーします。

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

public static string? PtrToStringUni (IntPtr ptr);

static member PtrToStringUni : nativeint -> string

Public Shared Function PtrToStringUni (ptr As IntPtr) As String

パラメーター

ptr

IntPtr

nativeint

アンマネージ文字列の最初の文字のアドレス。

戻り値

String

ptr パラメーターの値が nullされていない場合にアンマネージ文字列のコピーを保持するマネージド文字列。それ以外の場合、このメソッドは nullを返します。

注釈

PtrToStringUni は、カスタム マーシャリングや、マネージド コードとアンマネージド コードを混在するときに使用する場合に便利です。 このメソッドはアンマネージ文字列の内容のコピーを作成するため、必要に応じて元の文字列を解放する必要があります。 このメソッドは、Marshal.StringToCoTaskMemUni メソッドと Marshal.StringToHGlobalUni メソッドの逆の機能を提供します。

この API には、UTF-16 2 バイト エンコードである Unicode の Windows 定義が反映されています。 Windows 以外の多くのプラットフォームでは、wchar_t データ型は 2 バイトではなく 4 バイトです。 コンパイラに問い合わせて、wchar_t を使用できるかどうかを確認するか、代わりに char16_t 使用する必要があるかどうかを確認します。

こちらもご覧ください

• StringToCoTaskMemAnsi(String)
• StringToHGlobalAnsi(String)

PtrToStringUni(IntPtr, Int32)

ソース:

Marshal.cs

マネージド String を割り当て、アンマネージド Unicode 文字列から指定した数の文字をコピーします。

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

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

static member PtrToStringUni : nativeint * int -> string

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

パラメーター

ptr

IntPtr

nativeint

アンマネージ文字列の最初の文字のアドレス。

len

Int32

コピーする Unicode 文字の数。

戻り値

String

ptr パラメーターの値が nullされていない場合にアンマネージ文字列のコピーを保持するマネージド文字列。それ以外の場合、このメソッドは nullを返します。

注釈

PtrToStringUni は、カスタム マーシャリングや、マネージド コードとアンマネージド コードを混在する場合に便利です。 このメソッドはアンマネージ文字列の内容のコピーを作成するため、必要に応じて元の文字列を解放する必要があります。 このメソッドは、Marshal.StringToCoTaskMemUni メソッドと Marshal.StringToHGlobalUni メソッドの逆の機能を提供します。

この API には、UTF-16 2 バイト エンコードである Unicode の Windows 定義が反映されています。 Windows 以外の多くのプラットフォームでは、wchar_t データ型は 2 バイトではなく 4 バイトです。 コンパイラに問い合わせて、wchar_t を使用できるかどうかを確認するか、代わりに char16_t 使用する必要があるかどうかを確認します。

こちらもご覧ください

• StringToCoTaskMemAnsi(String)
• StringToHGlobalAnsi(String)