英語で読む

次の方法で共有


C++/CLI におけるマーシャリングの概要

混合モードでは、ネイティブ型とマネージド型の間でデータをマーシャリングすることが必要な場合があります。 マーシャリング ライブラリ は、単純な方法でデータをマーシャリングして変換できます。 マーシャリング ライブラリは、一連の関数と、共通の型のマーシャリングを実行する marshal_context クラスで構成されます。 ライブラリは、次のヘッダーで、お使いの Visual Studio エディションの include/msclr ディレクトリで定義されています。

Header 説明
marshal.h marshal_context クラスとコンテキストフリーのマーシャリング関数
marshal_atl.h ATL 型をマーシャリングする関数
marshal_cppstd.h 標準 C++ 型をマーシャリングする関数
marshal_windows.h Windows 型をマーシャリングする関数

msclr フォルダーの既定のパスは、使用しているエディションとビルド番号に応じて次のようなものです。

C:\\Program Files (x86)\\Microsoft Visual Studio\\Preview\\Enterprise\\VC\\Tools\\MSVC\\14.15.26528\\include\\msclr

マーシャリング ライブラリは、marshal_context Class ありでもなしでも使用できます。 一部の変換では、コンテキストが必要です。 他の変換は、marshal_as 関数を使用して実装できます。 次の表は、現在サポートされている変換と、コンテキストが必要かどうか、含める必要があるマーシャリング ファイルを示しています。

変換前の型 変換後の型 マーシャリング メソッド インクルード ファイル
System::String^ const char* marshal_context marshal.h
const char* System::String^ marshal_as marshal.h
char * System::String^ marshal_as marshal.h
System::String^ const wchar_t* marshal_context marshal.h
const wchar_t* System::String^ marshal_as marshal.h
wchar_t * System::String^ marshal_as marshal.h
System::IntPtr HANDLE marshal_as marshal_windows.h
HANDLE System::IntPtr marshal_as marshal_windows.h
System::String^ BSTR marshal_context marshal_windows.h
BSTR System::String^ marshal_as marshal.h
System::String^ bstr_t marshal_as marshal_windows.h
bstr_t System::String^ marshal_as marshal_windows.h
System::String^ std::string marshal_as marshal_cppstd.h
std::string System::String^ marshal_as marshal_cppstd.h
System::String^ std::wstring marshal_as marshal_cppstd.h
std::wstring System::String^ marshal_as marshal_cppstd.h
System::String^ CStringT<char> marshal_as marshal_atl.h
CStringT<char> System::String^ marshal_as marshal_atl.h
System::String^ CStringT<wchar_t> marshal_as marshal_atl.h
CStringT<wchar_t> System::String^ marshal_as marshal_atl.h
System::String^ CComBSTR marshal_as marshal_atl.h
CComBSTR System::String^ marshal_as marshal_atl.h

マーシャリングにコンテキストが必要なのは、マネージド データ型からネイティブ データ型にマーシャリングし、変換先のネイティブ型に自動クリーンアップ用のデストラクターがない場合のみです。 マーシャリング コンテキストは、デストラクターの中で割り当てられているネイティブ データ型を破棄します。 したがって、コンテキストを必要とする変換は、コンテキストが削除されるまでしか有効ではありません。 マーシャリングされた値を保存するには、独自の変数に値をコピーする必要があります。

注意

文字列に NULL が埋め込まれている場合、文字列のマーシャリング結果は保証されません。 埋め込まれた NULL により、文字列が切り詰められたり残されたりする場合があります。

次の例では、インクルード ヘッダー宣言で msclr ディレクトリをインクルードする方法を示しています。

#include "msclr\marshal_cppstd.h"

マーシャリング ライブラリは、独自のマーシャリング型を追加できるように拡張できます。 マーシャリング ライブラリの拡張の詳細については、「方法: マーシャリング ライブラリを拡張する」をご覧ください。

関連項目

C++ のサポート ライブラリ
方法: マーシャリング ライブラリを拡張する