方法: ラッパを手動で作成する
マネージ ソース コード内で COM の型を手動で宣言することにした場合、まず既存のインターフェイス定義言語 (IDL: Interface Definition Language) ファイルまたはタイプ ライブラリを用意することをお勧めします。 IDL ファイルがないか、またはタイプ ライブラリ ファイルを生成できない場合には、マネージ宣言を作成してその結果のアセンブリをタイプ ライブラリにエクスポートすることで、COM の型をシミュレートできます。
マネージ ソースから COM の型をシミュレートするには
共通言語仕様 (CLS: Common Language Specification) に準拠した言語を使用して型を宣言してからファイルをコンパイルします。
タイプ ライブラリ エクスポーター (Tlbexp.exe) を使用して、その型を含むアセンブリをエクスポートします。
エクスポートした COM タイプ ライブラリを、COM 指向のマネージ型を宣言するための基礎として使用します。
ランタイム呼び出し可能ラッパー (RCW: Runtime Callable Wrapper) を作成するには
IDL ファイルまたはタイプ ライブラリ ファイルがあることを前提として、カスタム RCW に含めるクラスとインターフェイスを決定します。 アプリケーション内で直接にも間接にも使用される予定がない型がある場合は、それらを除外できます。
CLS 準拠言語でソース ファイルを作成し、型を宣言します。 インポート変換プロセスの詳しい説明については、「タイプ ライブラリからアセンブリへの変換の要約」を参照してください。 実際には、カスタム RCW を作成する場合は、タイプ ライブラリ インポーター (Tlbimp.exe) によって提供される型変換機能を手動で実行していることになります。 IDL またはタイプ ライブラリ ファイル内の型と、C# コード内でそれぞれに対応する型について、この手順に従った例に示します。
宣言が完成したら、他のマネージ ソース コードのコンパイルと同様に、このファイルをコンパイルします。
Tlbimp.exe でインポートする型と同様に、追加情報が必要となる場合があります。その場合には、コードに直接追加できます。 詳細については、「方法 : 相互運用機能アセンブリを編集する」を参照してください。
使用例
IDL に含まれる ISATest インターフェイスおよび SATest クラスの例と、C# ソース コードのそれらに対応する型を次のコードに示します。
IDL またはタイプ ライブラリ ファイル
[
object,
uuid(40A8C65D-2448-447A-B786-64682CBEF133),
dual,
helpstring("ISATest Interface"),
pointer_default(unique)
]
interface ISATest : IDispatch
{
[id(1), helpstring("method InSArray")]
HRESULT InSArray([in] SAFEARRAY(int) *ppsa, [out,retval] int *pSum);
};
[
uuid(116CCA1E-7E39-4515-9849-90790DA6431E),
helpstring("SATest Class")
]
coclass SATest
{
[default] interface ISATest;
};
マネージ ソース コード内のラッパー
using System;
using System.Runtime.InteropServices;
using System.Runtime.CompilerServices;
[assembly:Guid("E4A992B8-6F5C-442C-96E7-C4778924C753")]
[assembly:ImportedFromTypeLib("SAServerLib")]
namespace SAServer
{
[ComImport]
[Guid("40A8C65D-2448-447A-B786-64682CBEF133")]
[TypeLibType(TypeLibTypeFlags.FLicensed)]
public interface ISATest
{
[DispId(1)]
//[MethodImpl(MethodImplOptions.InternalCall,
// MethodCodeType=MethodCodeType.Runtime)]
int InSArray( [MarshalAs(UnmanagedType.SafeArray,
SafeArraySubType=VarEnum.VT_I4)] ref int[] param );
}
[ComImport]
[Guid("116CCA1E-7E39-4515-9849-90790DA6431E")]
[ClassInterface(ClassInterfaceType.None)]
[TypeLibType(TypeLibTypeFlags.FCanCreate)]
public class SATest : ISATest
{
[DispId(1)]
[MethodImpl(MethodImplOptions.InternalCall,
MethodCodeType=MethodCodeType.Runtime)]
extern int ISATest.InSArray( [MarshalAs(UnmanagedType.SafeArray,
SafeArraySubType=VarEnum.VT_I4)] ref int[] param );
}
}
参照
処理手順
参照
Tlbexp.exe (タイプ ライブラリ エクスポーター)