ILGenerator.EmitCalli

.NET Framework クラス ライブラリ リファレンス

ILGenerator.EmitCalli メソッド (OpCode, CallingConvention, Type, Type[])

間接的な呼び出しに対してアンマネージ呼び出し規約を指定して、MSIL (Microsoft Intermediate Language) ストリームに Calli 命令を書き込みます。

名前空間: System.Reflection.Emit
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub EmitCalli
 ( _
    opcode As OpCode, _
    unmanagedCallConv As CallingConvention, _
    returnType As Type, _
    parameterTypes As Type() _
)

Visual Basic (使用法)

Dim instance As ILGenerator
Dim opcode As OpCode
Dim unmanagedCallConv As CallingConvention
Dim returnType As Type
Dim parameterTypes As Type()

instance.EmitCalli(opcode, unmanagedCallConv, returnType, parameterTypes)

C#

public virtual void EmitCalli (
    OpCode opcode,
    CallingConvention unmanagedCallConv,
    Type returnType,
    Type[] parameterTypes
)

C++

public:
virtual void EmitCalli (
    OpCode opcode, 
    CallingConvention unmanagedCallConv, 
    Type^ returnType, 
    array<Type^>^ parameterTypes
)

J#

public void EmitCalli (
    OpCode opcode, 
    CallingConvention unmanagedCallConv, 
    Type returnType, 
    Type[] parameterTypes
)

JScript

public function EmitCalli (
    opcode : OpCode, 
    unmanagedCallConv : CallingConvention, 
    returnType : Type, 
    parameterTypes : Type[]
)

パラメータ

opcode

ストリームに書き込む MSIL 命令。

unmanagedCallConv

使用するアンマネージ呼び出し規約。

returnType

結果の Type。

parameterTypes

命令に必要な引数の型。

解説

Calli 命令をストリームに書き込むには、EmitCalli を使用します。Emit は使用しないでください。

使用例

次のコード例は、EmitCalli メソッドを使用して、動的なクラスの外部にあるアンマネージ型のメソッドを呼び出す方法を示しています。

Visual Basic

      Dim myMthdBuilder As MethodBuilder = myTypeBuilder.DefineMethod("MyMethod",
 _
                    MethodAttributes.Public, _
                    returnType, mthdParamTypes)
  
      ' We will assume that an external unmanaged type "LegacyNumber"
 has been loaded, and
      ' that it has a method "ToString" which returns a string.

      Dim unmanagedMthdMI As MethodInfo = Type.GetType("LegacyNumber").GetMethod("ToString")
      Dim myMthdIL As ILGenerator = myMthdBuilder.GetILGenerator()
  
      ' Code to emit various IL opcodes here ...
      ' Load a reference to the specific object instance onto the stack.

      myMthdIL.Emit(OpCodes.Ldc_I4, addrOfLegacyNumberObject)
      myMthdIL.Emit(OpCodes.Ldobj, Type.GetType("LegacyNumber"))
  
      ' Make the call to the unmanaged type method, telling it that
 the method is
      ' the member of a specific instance, to expect a string 
      ' as a return value, and that there are no explicit parameters.

      myMthdIL.EmitCalli(OpCodes.Calli, System.Runtime.InteropServices.CallingConvention.ThisCall,
 _
                  GetType(String), New
 Type() {})

' More IL code emission here ...

C#

MethodBuilder myMthdBuilder = myTypeBuilder.DefineMethod("MyMethod", 
                  MethodAttributes.Public,
                  returnType, mthdParamTypes);
                            
// We will assume that an external unmanaged type "LegacyNumber"
 has been loaded, and
// that it has a method "ToString" which returns a string.
 
MethodInfo unmanagedMthdMI = Type.GetType("LegacyNumber").GetMethod("ToString");
ILGenerator myMthdIL = myMthdBuilder.GetILGenerator();

// Code to emit various IL opcodes here ...

// Load a reference to the specific object instance onto the stack.

myMthdIL.Emit(OpCodes.Ldc_I4, addrOfLegacyNumberObject);
myMthdIL.Emit(OpCodes.Ldobj, Type.GetType("LegacyNumber"));

// Make the call to the unmanaged type method, telling it that the method
 is
// the member of a specific instance, to expect a string 
// as a return value, and that there are no explicit parameters.
myMthdIL.EmitCalli(OpCodes.Calli, 
           System.Runtime.InteropServices.CallingConvention.ThisCall,
               typeof(string),
           new Type[] {});

// More IL code emission here ...

C++

MethodBuilder^ myMthdBuilder = myTypeBuilder->DefineMethod( "MyMethod"
,
                               MethodAttributes::Public,
                               returnType, mthdParamTypes );

// We will assume that an external unmanaged type "LegacyNumber"
 has been loaded, and
// that it has a method "ToString" which returns a String.

MethodInfo^ unmanagedMthdMI = Type::GetType( "LegacyNumber" )->GetMethod(
 "ToString" );
ILGenerator^ myMthdIL = myMthdBuilder->GetILGenerator();

// Code to emit various IL opcodes here ...

// Load a reference to the specific Object instance onto the stack.

myMthdIL->Emit( OpCodes::Ldc_I4, addrOfLegacyNumberObject );
myMthdIL->Emit( OpCodes::Ldobj, Type::GetType( "LegacyNumber" ) );

// Make the call to the unmanaged type method, telling it that the method
 is
// the member of a specific instance, to expect a String
// as a return value, and that there are no explicit parameters.
myMthdIL->EmitCalli( OpCodes::Calli,
                     System::Runtime::InteropServices::CallingConvention::ThisCall
,
                     String::typeid,
                     gcnew array<Type^>( 0 ) );

// More IL code emission here ...

J#

MethodBuilder myMthdBuilder = myTypeBuilder.DefineMethod("MyMethod",
    MethodAttributes.Public, returnType, mthdParamTypes);

// We will assume that an external unmanaged type "LegacyNumber"
 
// has been loaded, and that it has a method "ToString" which
 returns
// a string.
MethodInfo unmanagedMthdMI = Type.GetType(
    "LegacyNumber").GetMethod("ToString");
ILGenerator myMthdIL = myMthdBuilder.GetILGenerator();

// Code to emit various IL opcodes here ...
// Load a reference to the specific object instance onto the stack.
myMthdIL.Emit(OpCodes.Ldc_I4, addrOfLegacyNumberObject);
myMthdIL.Emit(OpCodes.Ldobj, Type.GetType("LegacyNumber"));

// Make the call to the unmanaged type method, telling it that the 
// method is the member of a specific instance, to expect a string 
// as a return value, and that there are no explicit parameters.
myMthdIL.EmitCalli(OpCodes.Calli, 
    System.Runtime.InteropServices.CallingConvention.ThisCall, 
    String.class.ToType(), new Type[] {});
// More IL code emission here ...

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ILGenerator クラス
ILGenerator メンバ
System.Reflection.Emit 名前空間

ILGenerator.EmitCalli メソッド (OpCode, CallingConventions, Type, Type[], Type[])

間接的な呼び出しに対してマネージ呼び出し規約を指定して、MSIL (Microsoft Intermediate Language) ストリームに Calli 命令を書き込みます。

名前空間: System.Reflection.Emit
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub EmitCalli
 ( _
    opcode As OpCode, _
    callingConvention As CallingConventions, _
    returnType As Type, _
    parameterTypes As Type(), _
    optionalParameterTypes As Type() _
)

Visual Basic (使用法)

Dim instance As ILGenerator
Dim opcode As OpCode
Dim callingConvention As CallingConventions
Dim returnType As Type
Dim parameterTypes As Type()
Dim optionalParameterTypes As Type()

instance.EmitCalli(opcode, callingConvention, returnType, parameterTypes, optionalParameterTypes)

C#

public virtual void EmitCalli (
    OpCode opcode,
    CallingConventions callingConvention,
    Type returnType,
    Type[] parameterTypes,
    Type[] optionalParameterTypes
)

C++

public:
virtual void EmitCalli (
    OpCode opcode, 
    CallingConventions callingConvention, 
    Type^ returnType, 
    array<Type^>^ parameterTypes, 
    array<Type^>^ optionalParameterTypes
)

J#

public void EmitCalli (
    OpCode opcode, 
    CallingConventions callingConvention, 
    Type returnType, 
    Type[] parameterTypes, 
    Type[] optionalParameterTypes
)

JScript

public function EmitCalli (
    opcode : OpCode, 
    callingConvention : CallingConventions, 
    returnType : Type, 
    parameterTypes : Type[], 
    optionalParameterTypes : Type[]
)

パラメータ

opcode

ストリームに書き込む MSIL 命令。

callingConvention

使用するマネージ呼び出し規約。

returnType

結果の Type。

parameterTypes

命令に必要な引数の型。

optionalParameterTypes

varargs 呼び出しの省略可能な引数の型。

例外

例外の種類	条件
InvalidOperationException	optionalParameterTypes が null 参照 (Visual Basic では Nothing) でないにもかかわらず、callingConvention に CallingConventions.VarArgs フラグが含まれていません。

解説

Calli 命令をストリームに書き込むには、EmitCalli を使用します。Emit は使用しないでください。

optionalParameterTypes で省略可能な引数を指定する場合、callingConvention に CallingConventions.VarArgs フラグが含まれている必要があります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ILGenerator クラス
ILGenerator メンバ
System.Reflection.Emit 名前空間

ILGenerator.EmitCalli メソッド

Microsoft Intermediate Language (MSIL) ストリームに Calli 命令を書き込みます。
オーバーロードの一覧

名前	説明
ILGenerator.EmitCalli (OpCode, CallingConvention, Type, Type[])	間接的な呼び出しに対してアンマネージ呼び出し規約を指定して、MSIL (Microsoft Intermediate Language) ストリームに Calli 命令を書き込みます。
ILGenerator.EmitCalli (OpCode, CallingConventions, Type, Type[], Type[])	間接的な呼び出しに対してマネージ呼び出し規約を指定して、MSIL (Microsoft Intermediate Language) ストリームに Calli 命令を書き込みます。

参照

関連項目

ILGenerator クラス
ILGenerator メンバ
System.Reflection.Emit 名前空間