Marshal.StringToHGlobalUni(String) メソッド
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
マネージド String の内容をアンマネージド メモリにコピーします。
public:
static IntPtr StringToHGlobalUni(System::String ^ s);[System.Security.SecurityCritical]
public static IntPtr StringToHGlobalUni(string s);public static IntPtr StringToHGlobalUni(string? s);public static IntPtr StringToHGlobalUni(string s);[<System.Security.SecurityCritical>]
static member StringToHGlobalUni : string -> nativeintstatic member StringToHGlobalUni : string -> nativeintPublic Shared Function StringToHGlobalUni (s As String) As IntPtr- s
- String
コピーされるマネージド文字列。
nativeint
s のコピー先となったアンマネージ メモリ内のアドレス。s が null の場合は 0。
- 属性
メソッドが十分なネイティブ ヒープ メモリを割り当てることができませんでした。
s パラメーターがオペレーティング システムで許可されている最大長を超えています。
StringToHGlobalUni は、カスタム マーシャリングや、マネージド コードとアンマネージド コードを混在する場合に使用する場合に便利です。 このメソッドは文字列に必要なアンマネージ メモリを割り当てるので、 を呼び出 FreeHGlobalして常にメモリを解放します。 このメソッドは、 の逆の機能を Marshal.PtrToStringUni提供します。
このメソッドは、埋め込まれた null 文字をコピーし、終端の null 文字を含みます。
この API には、UTF-16 2 バイト エンコードである Unicode の Windows 定義が反映されています。 多くの Windows 以外のプラットフォームでは、 wchar_t データ型は 2 バイトではなく 4 バイトです。 コンパイラに問い合わせて、使用できるかどうかを確認するかchar16_t、代わりに使用する必要があるかどうかを確認wchar_tします。
| 製品 | バージョン |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。