Type.DefaultBinder Type.DefaultBinder Type.DefaultBinder Type.DefaultBinder Property

定義

既定のバインダーへの参照を取得します。このバインダーは、InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]) によって呼び出される適切なメンバーを選択するための内部規則を実装します。Gets a reference to the default binder, which implements internal rules for selecting the appropriate members to be called by InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]).

public:
 static property System::Reflection::Binder ^ DefaultBinder { System::Reflection::Binder ^ get(); };
public static System.Reflection.Binder DefaultBinder { get; }
member this.DefaultBinder : System.Reflection.Binder
Public Shared ReadOnly Property DefaultBinder As Binder

プロパティ値

システムで使用される既定のバインダーへの参照。A reference to the default binder used by the system.

次の例では、 DefaultBinderプロパティから既定のバインダーを取得し、 DefaultBinder値をパラメーターとしてにInvokeMember渡すことによって、MyClass のメンバーを呼び出します。The following example gets the default binder from the DefaultBinder property, and invokes a member of MyClass by passing the DefaultBinder value as a parameter to InvokeMember.

using namespace System;
using namespace System::Reflection;
ref class MyClass
{
public:
   void HelloWorld()
   {
      Console::WriteLine( "Hello World" );
   }

};

int main()
{
   try
   {
      Binder^ defaultBinder = Type::DefaultBinder;
      MyClass^ myClass = gcnew MyClass;
      
      // Invoke the HelloWorld method of MyClass.
      myClass->GetType()->InvokeMember( "HelloWorld", BindingFlags::InvokeMethod, defaultBinder, myClass, nullptr );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception : {0}", e->Message );
   }

}

using System;
using System.Reflection;

public class MyDefaultBinderSample
{
    public static void Main()
    {
        try
        {
            Binder defaultBinder = Type.DefaultBinder;
            MyClass myClass = new MyClass();
            // Invoke the HelloWorld method of MyClass.
            myClass.GetType().InvokeMember("HelloWorld", BindingFlags.InvokeMethod,
                defaultBinder, myClass, new object [] {});
        }
        catch(Exception e)
        {
            Console.WriteLine("Exception :" + e.Message);
        }
    }	

    class MyClass
    {
        public void HelloWorld()
        {
            Console.WriteLine("Hello World");
        }	
    }
}
Imports System.Reflection

Public Class MyDefaultBinderSample
    Public Shared Sub Main()
        Try
            Dim defaultBinder As Binder = Type.DefaultBinder
            Dim [myClass] As New [MyClass]()
            ' Invoke the HelloWorld method of MyClass.
            [myClass].GetType().InvokeMember("HelloWorld", BindingFlags.InvokeMethod, defaultBinder, [myClass], New Object() {})
        Catch e As Exception
            Console.WriteLine("Exception :" + e.Message.ToString())
        End Try
    End Sub

    Class [MyClass]

        Public Sub HelloWorld()
            Console.WriteLine("Hello World")
        End Sub
    End Class
End Class

注釈

共通言語ランタイムに用意されている既定のバインダーは、特に特殊化されたすべての状況で適用できます。The default binder provided with the common language runtime is applicable in all but the most specialized circumstances. 指定された既定のバインダーとは異なる規則に従うバインダーが必要な場合は、 Binderクラスから派生した型を定義し、いずれかのInvokeMemberオーバーロードbinderのパラメーターを使用して、その型のインスタンスを渡します。If you need a binder that follows rules that differ from those of the supplied default binder, define a type derived from the Binder class and pass an instance of that type using the binder parameter of one of the InvokeMember overloads.

リフレクションは、共通型システムのアクセシビリティ規則をモデル化します。Reflection models the accessibility rules of the common type system. たとえば、呼び出し元が同じアセンブリ内にある場合、呼び出し元は内部メンバーに対して特別なアクセス許可を必要としません。For example, if the caller is in the same assembly, the caller does not need special permissions for internal members. それ以外の場合、 ReflectionPermission呼び出し元にはが必要です。Otherwise, the caller needs ReflectionPermission. これは、protected、private などのメンバーの参照と一致します。This is consistent with lookup of members that are protected, private, and so on.

一般的な原則は、 ChangeTypeでは、データを失うことのない拡大変換のみを実行することです。The general principle is that ChangeType should perform only widening conversions, which never lose data. 拡大変換の例として、32ビット符号付き整数の値を64ビット符号付き整数値に変換する場合が挙げられます。An example of a widening conversion is converting a value that is a 32-bit signed integer to a value that is a 64-bit signed integer. これは縮小変換と区別されるため、データが失われる可能性があります。This is distinguished from a narrowing conversion, which may lose data. 縮小変換の例としては、64ビット符号付き整数を32ビット符号付き整数に変換することが挙げられます。An example of a narrowing conversion is converting a 64-bit signed integer to a 32-bit signed integer.

次の表に、既定のバインダーでサポートされている変換の一覧を示します。The following table lists the conversions supported by the default binder.

ソースの種類Source Type ターゲットの種類Target Type
任意の型Any type その基本型。Its base type.
任意の型Any type 実装するインターフェイス。The interface it implements.
CharChar Unt16、UInt32、Int32、UInt64、Int64、Single、DoubleUnt16, UInt32, Int32, UInt64, Int64, Single, Double
ByteByte Char、Unt16、Int16、UInt32、Int32、UInt64、Int64、Single、DoubleChar, Unt16, Int16, UInt32, Int32, UInt64, Int64, Single, Double
SByteSByte Int16、Int32、Int64、Single、DoubleInt16, Int32, Int64, Single, Double
UInt16UInt16 UInt32、Int32、UInt64、Int64、Single、DoubleUInt32, Int32, UInt64, Int64, Single, Double
Int16Int16 Int32、Int64、Single、DoubleInt32, Int64, Single, Double
UInt32UInt32 UInt64、Int64、Single、DoubleUInt64, Int64, Single, Double
Int32Int32 Int64、Single、DoubleInt64, Single, Double
UInt64UInt64 Single、DoubleSingle, Double
Int64Int64 Single、DoubleSingle, Double
SingleSingle 倍精度浮動小数点型Double
非参照Non-reference 参照渡し。By-reference.

適用対象

こちらもご覧ください