Type.InvokeMember Metodo

Quando ne viene eseguito l'override in una classe derivata, richiama il membro specificato, usando i vincoli di binding specificati e associando l'elenco di argomenti, i modificatori e le impostazioni cultura specificati.When overridden in a derived class, invokes the specified member, using the specified binding constraints and matching the specified argument list, modifiers and culture.

public:
 abstract System::Object ^ InvokeMember(System::String ^ name, System::Reflection::BindingFlags invokeAttr, System::Reflection::Binder ^ binder, System::Object ^ target, cli::array <System::Object ^> ^ args, cli::array <System::Reflection::ParameterModifier> ^ modifiers, System::Globalization::CultureInfo ^ culture, cli::array <System::String ^> ^ namedParameters);

public abstract object InvokeMember (string name, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder binder, object target, object[] args, System.Reflection.ParameterModifier[] modifiers, System.Globalization.CultureInfo culture, string[] namedParameters);

abstract member InvokeMember : string * System.Reflection.BindingFlags * System.Reflection.Binder * obj * obj[] * System.Reflection.ParameterModifier[] * System.Globalization.CultureInfo * string[] -> obj

Parametri

Restituisce

Implementazioni

Eccezioni

Commenti

InvokeMemberchiama un membro del costruttore o un membro del metodo, ottiene o imposta un membro della proprietà, ottiene o imposta un membro del campo dati oppure ottiene o imposta un elemento di un membro di matrice.InvokeMember calls a constructor member or a method member, gets or sets a property member, gets or sets a data field member, or gets or sets an element of an array member.

Quando si richiama un IDispatch membro è possibile specificare il DISPID anziché il nome del membro, usando il formato stringa "[DISPID = # #]".When you invoke an IDispatch member you can specify the DispID instead of the member name, using the string format "[DispID=##]". Se, ad esempio, il DispID di MyComMethod è 3, è possibile specificare la stringa "[DispID = 3]" anziché "MyComMethod".For example, if the DispID of MyComMethod is 3, you can specify the string "[DispID=3]" instead of "MyComMethod". La chiamata di un membro tramite DispID è più veloce rispetto alla ricerca del membro in base al nome.Invoking a member by DispID is faster than looking up the member by name. Negli scenari di aggregazione complessi, il DispID è talvolta l'unico modo per richiamare il membro desiderato.In complex aggregation scenarios, the DispID is sometimes the only way to invoke the desired member.

Sebbene il binder predefinito non elabori ParameterModifier o CultureInfo (i modifiers parametri e culture ), è possibile usare la classe astratta System.Reflection.Binder per scrivere un gestore di associazione personalizzato che elabora modifiers e culture.Although the default binder does not process ParameterModifier or CultureInfo (the modifiers and culture parameters), you can use the abstract System.Reflection.Binder class to write a custom binder that does process modifiers and culture. ParameterModifierviene utilizzato solo quando si effettua una chiamata tramite l'interoperabilità COM e vengono gestiti solo i parametri passati per riferimento.ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.

Tutti i parametri nella matrice namedParameters ottengono il valore nell'elemento corrispondente della matrice args.Each parameter in the namedParameters array gets the value in the corresponding element in the args array. Se la lunghezza di args è superiore a quella di namedParameters, i valori degli argomenti rimanenti vengono passati in ordine.If the length of args is greater than the length of namedParameters, the remaining argument values are passed in order.

La namedParameters matrice può essere utilizzata per modificare l'ordine degli argomenti in una matrice di input.The namedParameters array can be used to change the order of arguments in an input array. M(string a, int b) Dato il metodo (M(ByVal a As String, ByVal b As Integer) in Visual Basic) e la matrice { 42, "x" }di input, ad esempio, la matrice di input può essere passata senza modifiche args a se la { "b", "a" } matrice viene fornita namedParametersper.For example, given the method M(string a, int b) (M(ByVal a As String, ByVal b As Integer) in Visual Basic) and the input array { 42, "x" }, the input array can be passed unchanged to args if the array { "b", "a" } is supplied for namedParameters.

I flag BindingFlags di filtro seguenti possono essere usati per definire i membri da includere nella ricerca:The following BindingFlags filter flags can be used to define which members to include in the search:

• Consente BindingFlags.Public di specificare di includere i membri pubblici nella ricerca.Specify BindingFlags.Public to include public members in the search.

• Specificare BindingFlags.NonPublic per includere i membri non pubblici (ovvero i membri privati, interni e protetti) nella ricerca.Specify BindingFlags.NonPublic to include non-public members (that is, private, internal, and protected members) in the search.

• Specificare BindingFlags.FlattenHierarchy per includere i membri statici nella gerarchia.Specify BindingFlags.FlattenHierarchy to include static members up the hierarchy.

I flag BindingFlags di modifica seguenti possono essere utilizzati per modificare il funzionamento della ricerca:The following BindingFlags modifier flags can be used to change how the search works:

• BindingFlags.IgnoreCaseper ignorare la distinzione tra namemaiuscole e minuscole.BindingFlags.IgnoreCase to ignore the case of name.

• BindingFlags.DeclaredOnlyper cercare solo i membri dichiarati Typein, non i membri che sono stati semplicemente ereditati.BindingFlags.DeclaredOnly to search only the members declared on the Type, not members that were simply inherited.

I flag BindingFlags di chiamata seguenti possono essere usati per indicare l'azione da eseguire con il membro:The following BindingFlags invocation flags can be used to denote what action to take with the member:

• CreateInstanceper richiamare un costruttore.CreateInstance to invoke a constructor. nameviene ignorato.name is ignored. Non valido con altri flag di chiamata.Not valid with other invocation flags.

• InvokeMethodper richiamare un metodo, ma non un costruttore o un inizializzatore di tipo.InvokeMethod to invoke a method, but not a constructor or a type initializer. Non valido con SetField o SetProperty.Not valid with SetField or SetProperty. Se InvokeMethod viene specificato da solo BindingFlags.Instance, BindingFlags.Public, e BindingFlags.Static vengono inclusi automaticamente.If InvokeMethod is specified by itself, BindingFlags.Public, BindingFlags.Instance, and BindingFlags.Static are automatically included.

• GetFieldper ottenere il valore di un campo.GetField to get the value of a field. Non valido con SetField.Not valid with SetField.

• SetFieldper impostare il valore di un campo.SetField to set the value of a field. Non valido con GetField.Not valid with GetField.

• GetPropertyper ottenere una proprietà.GetProperty to get a property. Non valido con SetProperty.Not valid with SetProperty.

• SetPropertyper impostare una proprietà.SetProperty to set a property. Non valido con GetProperty.Not valid with GetProperty.

Per altre informazioni, vedere System.Reflection.BindingFlags.See System.Reflection.BindingFlags for more information.

Viene richiamato un metodo se si verificano entrambe le condizioni seguenti:A method will be invoked if both of the following conditions are true:

• Il numero di parametri nella dichiarazione di metodo è uguale al numero di argomenti nella args matrice (a meno che non siano definiti argomenti predefiniti per il membro e BindingFlags.OptionalParamBinding che sia specificato).The number of parameters in the method declaration equals the number of arguments in the args array (unless default arguments are defined on the member and BindingFlags.OptionalParamBinding is specified).

• Il tipo di ogni argomento può essere convertito dal gestore di associazione al tipo del parametro.The type of each argument can be converted by the binder to the type of the parameter.

Il Binder troverà tutti i metodi corrispondenti.The binder will find all of the matching methods. Questi metodi si basano sul tipo di binding richiesto (BindingFlags valori InvokeMethod, GetPropertye così via).These methods are found based upon the type of binding requested (BindingFlags values InvokeMethod, GetProperty, and so on). Il set di metodi viene filtrato in base al nome, al numero di argomenti e a un set di modificatori di ricerca definiti nel gestore di associazione.The set of methods is filtered by the name, number of arguments, and a set of search modifiers defined in the binder.

Una volta selezionato, il metodo viene richiamato.After the method is selected, it is invoked. L'accessibilità viene controllata a questo punto.Accessibility is checked at that point. La ricerca può controllare il set di metodi in base all'attributo di accessibilità associato al metodo.The search may control which set of methods are searched based upon the accessibility attribute associated with the method. Il Binder.BindToMethod metodoBinder della classe è responsabile della selezione del metodo da richiamare.The Binder.BindToMethod method of the Binder class is responsible for selecting the method to be invoked. Il binder predefinito seleziona la corrispondenza più specifica.The default binder selects the most specific match.

InvokeMemberpuò essere usato per richiamare i metodi con parametri che hanno valori predefiniti.InvokeMember can be used to invoke methods with parameters that have default values. Per eseguire l'associazione a questi metodi, BindingFlags.OptionalParamBinding è necessario specificare la reflection.To bind to these methods, Reflection requires BindingFlags.OptionalParamBinding to be specified. Per un parametro con un valore predefinito, è possibile specificare un valore diverso o fornire Missing.Value per usare il valore predefinito.For a parameter that has a default value, you can either supply a different value, or supply Missing.Value to use the default value.

Si consideri, ad esempio, un metodo come MyMethod (int x, float y = 2,0).For example, consider a method such as MyMethod(int x, float y = 2.0). Per richiamare questo metodo solo con il primo argomento come MyMethod (4), passare uno dei flag di binding precedenti e passare due argomenti, ovvero 4 per il primo argomento e Missing.Value per il secondo argomento.To invoke this method with only the first argument as MyMethod(4), pass one of the above binding flags and pass two arguments, namely, 4 for the first argument and Missing.Value for the second argument. A meno che non Missing.Valuesi usi, non è possibile omettere i Invoke parametri facoltativi con il metodo.Unless you use Missing.Value, you may not omit optional parameters with the Invoke method. Se necessario, usare InvokeMember invece.If you must do so, use InvokeMember instead.

Le restrizioni di accesso vengono ignorate per il codice completamente attendibile; ovvero, i costruttori privati, i metodi, i campi e le proprietà possono essere accessibili e richiamati tramite System.Reflection ogni volta che il codice è completamente attendibile.Access restrictions are ignored for fully trusted code; that is, private constructors, methods, fields, and properties can be accessed and invoked through System.Reflection whenever the code is fully trusted.

È possibile utilizzare Type.InvokeMember per impostare un campo su un valore specifico specificando BindingFlags.SetField.You can use Type.InvokeMember to set a field to a particular value by specifying BindingFlags.SetField. Se, ad esempio, si vuole impostare un campo di istanza pubblica denominato F nella classe C e f è un String, è possibile usare codice come il seguente:For example, if you want to set a public instance field named F on class C, and F is a String, you can use code such as:

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {"strings new value"}, null, null, null);

Se F è un String[], è possibile usare codice come il seguente:If F is a String[], you can use code such as:

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {new String[]{"a","z","c","d"}}, null, null, null);

che consente di inizializzare il campo F nella nuova matrice.which will initialize the field F to this new array. È anche possibile usare Type.InvokeMember per impostare una posizione in una matrice fornendo l'indice del valore e quindi il valore successivo usando un codice simile al seguente:You can also use Type.InvokeMember to set a position in an array by supplying the index of the value and then the next value by using code such as the following:

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {1, "b"}, null, null, null);

In questo modo verrà modificata la stringa "z" nella matrice che F viene mantenuta nella stringa "b".This will change string "z" in the array that F holds to string "b".

Sicurezza

ReflectionPermission
per accedere ai membri non pubblici indipendentemente dal set di concessioni.for accessing non-public members regardless of their grant set. Enumerazione associata:MemberAccessAssociated enumeration: MemberAccess

SecurityPermission
per chiamare codice non gestito.to call unmanaged code. Enumerazione associata:UnmanagedCodeAssociated enumeration: UnmanagedCode

Vedi anche

• String
• Binder
• DefaultBinder
• BindingFlags
• ParameterModifier
• ParameterAttributes
• CultureInfo
• ReflectionPermission

Chiama il membro specificato, usando i vincoli di associazione specificati e associando l'elenco di argomenti specificato.Invokes the specified member, using the specified binding constraints and matching the specified argument list.

public:
 virtual System::Object ^ InvokeMember(System::String ^ name, System::Reflection::BindingFlags invokeAttr, System::Reflection::Binder ^ binder, System::Object ^ target, cli::array <System::Object ^> ^ args);

public object InvokeMember (string name, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder binder, object target, object[] args);

abstract member InvokeMember : string * System.Reflection.BindingFlags * System.Reflection.Binder * obj * obj[] -> obj
override this.InvokeMember : string * System.Reflection.BindingFlags * System.Reflection.Binder * obj * obj[] -> obj

Parametri

Restituisce

Implementazioni

Eccezioni

Esempi

Nell'esempio seguente viene InvokeMember usato per accedere ai membri di un tipo.The following example uses InvokeMember to access members of a type.

using namespace System;
using namespace System::Reflection;

// This sample class has a field, constructor, method, and property.
ref class MyType
{
private:
   Int32 myField;

public:
   MyType( interior_ptr<Int32> x )
   {
       *x *= 5;
   }

   virtual String^ ToString() override
   {
      return myField.ToString();
   }

   property Int32 MyProp 
   {
      Int32 get()
      {
         return myField;
      }

      void set( Int32 value )
      {
         if ( value < 1 )
                  throw gcnew ArgumentOutOfRangeException( "value",value,"value must be > 0" );

         myField = value;
      }
   }
};

int main()
{
   Type^ t = MyType::typeid;

   // Create an instance of a type.
   array<Object^>^args = {8};
   Console::WriteLine( "The value of x before the constructor is called is {0}.", args[ 0 ] );
   Object^ obj = t->InvokeMember( nullptr, static_cast<BindingFlags>(BindingFlags::DeclaredOnly | BindingFlags::Public | BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::CreateInstance), nullptr, nullptr, args );
   Console::WriteLine( "Type: {0}", obj->GetType() );
   Console::WriteLine( "The value of x after the constructor returns is {0}.", args[ 0 ] );

   // Read and write to a field.
   array<Object^>^obj5 = {5};
   t->InvokeMember( "myField", static_cast<BindingFlags>(BindingFlags::DeclaredOnly | BindingFlags::Public | BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::SetField), nullptr, obj, obj5 );
   Int32 v = safe_cast<Int32>(t->InvokeMember( "myField", static_cast<BindingFlags>(BindingFlags::DeclaredOnly | BindingFlags::Public | BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::GetField), nullptr, obj, nullptr ));
   Console::WriteLine( "myField: {0}", v );

   // Call a method.
   String^ s = safe_cast<String^>(t->InvokeMember( "ToString", static_cast<BindingFlags>(BindingFlags::DeclaredOnly | BindingFlags::Public | BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::InvokeMethod), nullptr, obj, nullptr ));
   Console::WriteLine( "ToString: {0}", s );

   // Read and write a property. First, attempt to assign an
   // invalid value; then assign a valid value; finally, get
   // the value.
   try
   {
      // Assign the value zero to MyProp. The Property Set 
      // throws an exception, because zero is an invalid value.
      // InvokeMember catches the exception, and throws 
      // TargetInvocationException. To discover the real cause
      // you must catch TargetInvocationException and examine
      // the inner exception. 
      array<Object^>^obj0 = {(int^)0};
      t->InvokeMember( "MyProp", static_cast<BindingFlags>(BindingFlags::DeclaredOnly | BindingFlags::Public | BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::SetProperty), nullptr, obj, obj0 );
   }
   catch ( TargetInvocationException^ e ) 
   {
      // If the property assignment failed for some unexpected
      // reason, rethrow the TargetInvocationException.
      if ( e->InnerException->GetType() != ArgumentOutOfRangeException::typeid )
            throw;

      Console::WriteLine( "An invalid value was assigned to MyProp." );
   }

   array<Object^>^obj2 = {2};
   t->InvokeMember( "MyProp", static_cast<BindingFlags>(BindingFlags::DeclaredOnly | BindingFlags::Public | BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::SetProperty), nullptr, obj, obj2 );
   v =  safe_cast<Int32>(t->InvokeMember( "MyProp", static_cast<BindingFlags>(BindingFlags::DeclaredOnly | BindingFlags::Public | BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::GetProperty), nullptr, obj, nullptr ));
   Console::WriteLine( "MyProp: {0}", v );
}

using System;
using System.Reflection;

// This sample class has a field, constructor, method, and property.
class MyType 
{
    Int32 myField;
    public MyType(ref Int32 x) {x *= 5;}
    public override String ToString() {return myField.ToString();}
    public Int32 MyProp 
    {
        get {return myField;}
        set 
        { 
            if (value < 1) 
                throw new ArgumentOutOfRangeException("value", value, "value must be > 0");
            myField = value;
        }
    }
}

class MyApp 
{
    static void Main() 
    {
        Type t = typeof(MyType);
        // Create an instance of a type.
        Object[] args = new Object[] {8};
        Console.WriteLine("The value of x before the constructor is called is {0}.", args[0]);
        Object obj = t.InvokeMember(null, 
            BindingFlags.DeclaredOnly | 
            BindingFlags.Public | BindingFlags.NonPublic | 
            BindingFlags.Instance | BindingFlags.CreateInstance, null, null, args);
        Console.WriteLine("Type: " + obj.GetType().ToString());
        Console.WriteLine("The value of x after the constructor returns is {0}.", args[0]);

        // Read and write to a field.
        t.InvokeMember("myField", 
            BindingFlags.DeclaredOnly | 
            BindingFlags.Public | BindingFlags.NonPublic | 
            BindingFlags.Instance | BindingFlags.SetField, null, obj, new Object[] {5});
        Int32 v = (Int32) t.InvokeMember("myField", 
            BindingFlags.DeclaredOnly | 
            BindingFlags.Public | BindingFlags.NonPublic | 
            BindingFlags.Instance | BindingFlags.GetField, null, obj, null);
        Console.WriteLine("myField: " + v);

        // Call a method.
        String s = (String) t.InvokeMember("ToString", 
            BindingFlags.DeclaredOnly | 
            BindingFlags.Public | BindingFlags.NonPublic | 
            BindingFlags.Instance | BindingFlags.InvokeMethod, null, obj, null);
        Console.WriteLine("ToString: " + s);

        // Read and write a property. First, attempt to assign an
        // invalid value; then assign a valid value; finally, get
        // the value.
        try 
        {
            // Assign the value zero to MyProp. The Property Set 
            // throws an exception, because zero is an invalid value.
            // InvokeMember catches the exception, and throws 
            // TargetInvocationException. To discover the real cause
            // you must catch TargetInvocationException and examine
            // the inner exception. 
            t.InvokeMember("MyProp", 
                BindingFlags.DeclaredOnly | 
                BindingFlags.Public | BindingFlags.NonPublic | 
                BindingFlags.Instance | BindingFlags.SetProperty, null, obj, new Object[] {0});
        } 
        catch (TargetInvocationException e) 
        {
            // If the property assignment failed for some unexpected
            // reason, rethrow the TargetInvocationException.
            if (e.InnerException.GetType() != 
                typeof(ArgumentOutOfRangeException)) 
                throw;
            Console.WriteLine("An invalid value was assigned to MyProp.");
        }
        t.InvokeMember("MyProp", 
            BindingFlags.DeclaredOnly | 
            BindingFlags.Public | BindingFlags.NonPublic | 
            BindingFlags.Instance | BindingFlags.SetProperty, null, obj, new Object[] {2});
        v = (Int32) t.InvokeMember("MyProp", 
            BindingFlags.DeclaredOnly | 
            BindingFlags.Public | BindingFlags.NonPublic | 
            BindingFlags.Instance | BindingFlags.GetProperty, null, obj, null);
        Console.WriteLine("MyProp: " + v);
    }
}

Imports System.Reflection

' This sample class has a field, constructor, method, and property.
Class MyType
    Private myField As Int32

    Public Sub New(ByRef x As Int32)
        x *= 5
    End Sub

    Public Overrides Function ToString() As [String]
        Return myField.ToString()
    End Function 'ToString

    Public Property MyProp() As Int32
        Get
            Return myField
        End Get
        Set(ByVal Value As Int32)
            If Value < 1 Then
                Throw New ArgumentOutOfRangeException("value", Value, "value must be > 0")
            End If
            myField = Value
        End Set
    End Property
End Class

Class MyApp

    Shared Sub Main()
        Dim t As Type = GetType(MyType)
        ' Create an instance of a type.
        Dim args() As [Object] = {8}
        Console.WriteLine("The value of x before the constructor is called is {0}.", args(0))
        Dim obj As [Object] = t.InvokeMember(Nothing, BindingFlags.DeclaredOnly Or BindingFlags.Public Or BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.CreateInstance, Nothing, Nothing, args)
        Console.WriteLine("Type: {0}", obj.GetType().ToString())
        Console.WriteLine("The value of x after the constructor returns is {0}.", args(0))

        ' Read and write to a field.
        t.InvokeMember("myField", BindingFlags.DeclaredOnly Or BindingFlags.Public Or BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.SetField, Nothing, obj, New [Object]() {5})
        Dim v As Int32 = CType(t.InvokeMember("myField", BindingFlags.DeclaredOnly Or BindingFlags.Public Or BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.GetField, Nothing, obj, Nothing), Int32)
        Console.WriteLine("myField: {0}", v)

        ' Call a method.
        Dim s As [String] = CType(t.InvokeMember("ToString", BindingFlags.DeclaredOnly Or BindingFlags.Public Or BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.InvokeMethod, Nothing, obj, Nothing), [String])
        Console.WriteLine("ToString: {0}", s)

        ' Read and write a property. First, attempt to assign an
        ' invalid value; then assign a valid value; finally, get
        ' the value.
        Try
            ' Assign the value zero to MyProp. The Property Set 
            ' throws an exception, because zero is an invalid value.
            ' InvokeMember catches the exception, and throws 
            ' TargetInvocationException. To discover the real cause
            ' you must catch TargetInvocationException and examine
            ' the inner exception. 
            t.InvokeMember("MyProp", BindingFlags.DeclaredOnly Or BindingFlags.Public Or BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.SetProperty, Nothing, obj, New [Object]() {0})
        Catch e As TargetInvocationException
            ' If the property assignment failed for some unexpected
            ' reason, rethrow the TargetInvocationException.
            If Not e.InnerException.GetType() Is GetType(ArgumentOutOfRangeException) Then
                Throw
            End If
            Console.WriteLine("An invalid value was assigned to MyProp.")
        End Try
        t.InvokeMember("MyProp", BindingFlags.DeclaredOnly Or BindingFlags.Public Or BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.SetProperty, Nothing, obj, New [Object]() {2})
        v = CType(t.InvokeMember("MyProp", BindingFlags.DeclaredOnly Or BindingFlags.Public Or BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.GetProperty, Nothing, obj, Nothing), Int32)
        Console.WriteLine("MyProp: {0}", v)
    End Sub
End Class

Commenti

I flag BindingFlags di filtro seguenti possono essere usati per definire i membri da includere nella ricerca:The following BindingFlags filter flags can be used to define which members to include in the search:

• Consente BindingFlags.Public di specificare di includere i membri pubblici nella ricerca.Specify BindingFlags.Public to include public members in the search.

• Specificare BindingFlags.NonPublic per includere i membri non pubblici (ovvero membri privati e protetti) nella ricerca.Specify BindingFlags.NonPublic to include non-public members (that is, private and protected members) in the search.

• Specificare BindingFlags.FlattenHierarchy per includere i membri statici nella gerarchia.Specify BindingFlags.FlattenHierarchy to include static members up the hierarchy.

I flag BindingFlags di modifica seguenti possono essere utilizzati per modificare il funzionamento della ricerca:The following BindingFlags modifier flags can be used to change how the search works:

• BindingFlags.IgnoreCaseper ignorare la distinzione tra namemaiuscole e minuscole.BindingFlags.IgnoreCase to ignore the case of name.

• BindingFlags.DeclaredOnlyper cercare solo i membri dichiarati Typein, non i membri che sono stati semplicemente ereditati.BindingFlags.DeclaredOnly to search only the members declared on the Type, not members that were simply inherited.

I flag BindingFlags di chiamata seguenti possono essere usati per indicare l'azione da eseguire con il membro:The following BindingFlags invocation flags can be used to denote what action to take with the member:

• CreateInstanceper richiamare un costruttore.CreateInstance to invoke a constructor. nameviene ignorato.name is ignored. Non valido con altri flag di chiamata.Not valid with other invocation flags.

• InvokeMethodper richiamare un metodo, ma non un costruttore o un inizializzatore di tipo.InvokeMethod to invoke a method, but not a constructor or a type initializer. Non valido con SetField o SetProperty.Not valid with SetField or SetProperty. Se InvokeMethod viene specificato da solo BindingFlags.Instance, BindingFlags.Public, e BindingFlags.Static vengono inclusi automaticamente.If InvokeMethod is specified by itself, BindingFlags.Public, BindingFlags.Instance, and BindingFlags.Static are automatically included.

• GetFieldper ottenere il valore di un campo.GetField to get the value of a field. Non valido con SetField.Not valid with SetField.

• SetFieldper impostare il valore di un campo.SetField to set the value of a field. Non valido con GetField.Not valid with GetField.

• GetPropertyper ottenere una proprietà.GetProperty to get a property. Non valido con SetProperty.Not valid with SetProperty.

• SetPropertyper impostare una proprietà.SetProperty to set a property. Non valido con GetProperty.Not valid with GetProperty.

Per altre informazioni, vedere System.Reflection.BindingFlags.See System.Reflection.BindingFlags for more information.

Viene richiamato un metodo se si verificano entrambe le condizioni seguenti:A method will be invoked if both of the following conditions are true:

• Il numero di parametri nella dichiarazione di metodo è uguale al numero di argomenti nella args matrice (a meno che non siano definiti argomenti predefiniti per il membro e BindingFlags.OptionalParamBinding che sia specificato).The number of parameters in the method declaration equals the number of arguments in the args array (unless default arguments are defined on the member and BindingFlags.OptionalParamBinding is specified).

• Il tipo di ogni argomento può essere convertito dal gestore di associazione al tipo del parametro.The type of each argument can be converted by the binder to the type of the parameter.

Il Binder troverà tutti i metodi corrispondenti.The binder will find all of the matching methods. Questi metodi si basano sul tipo di binding richiesto (BindingFlags valori InvokeMethod, GetPropertye così via).These methods are found based upon the type of binding requested (BindingFlags values InvokeMethod, GetProperty, and so on). Il set di metodi viene filtrato in base al nome, al numero di argomenti e a un set di modificatori di ricerca definiti nel gestore di associazione.The set of methods is filtered by the name, number of arguments, and a set of search modifiers defined in the binder.

Una volta selezionato, il metodo viene richiamato.After the method is selected, it is invoked. L'accessibilità viene controllata a questo punto.Accessibility is checked at that point. La ricerca può controllare il set di metodi in base all'attributo di accessibilità associato al metodo.The search may control which set of methods are searched based upon the accessibility attribute associated with the method. Il Binder.BindToMethod metodoBinder della classe è responsabile della selezione del metodo da richiamare.The Binder.BindToMethod method of the Binder class is responsible for selecting the method to be invoked. Il binder predefinito seleziona la corrispondenza più specifica.The default binder selects the most specific match.

Le restrizioni di accesso vengono ignorate per il codice completamente attendibile; ovvero, i costruttori privati, i metodi, i campi e le proprietà possono essere accessibili e richiamati tramite System.Reflection ogni volta che il codice è completamente attendibile.Access restrictions are ignored for fully trusted code; that is, private constructors, methods, fields, and properties can be accessed and invoked through System.Reflection whenever the code is fully trusted.

È possibile utilizzare Type.InvokeMember per impostare un campo su un valore specifico specificando BindingFlags.SetField.You can use Type.InvokeMember to set a field to a particular value by specifying BindingFlags.SetField. Se, ad esempio, si vuole impostare un campo di istanza pubblica denominato F nella classe C e f è un String, è possibile usare codice come il seguente:For example, if you want to set a public instance field named F on class C, and F is a String, you can use code such as:

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {"strings new value"});

Se F è un String[], è possibile usare codice come il seguente:If F is a String[], you can use code such as:

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {new String[]{"a","z","c","d"}});

che consente di inizializzare il campo F nella nuova matrice.which will initialize the field F to this new array. È anche possibile usare Type.InvokeMember per impostare una posizione in una matrice fornendo l'indice del valore e quindi il valore successivo usando un codice simile al seguente:You can also use Type.InvokeMember to set a position in an array by supplying the index of the value and then the next value by using code such as the following:

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {1, "b"});

In questo modo verrà modificata la stringa "z" nella matrice che F viene mantenuta nella stringa "b".This will change string "z" in the array that F holds to string "b".

Quando si richiama un IDispatch membro, è possibile specificare il DISPID anziché il nome del membro, usando il formato stringa "[DISPID = # #]".When you invoke an IDispatch member, you can specify the DispID instead of the member name, using the string format "[DispID=##]". Se, ad esempio, il DispID di MyComMethod è 3, è possibile specificare la stringa "[DispID = 3]" anziché "MyComMethod".For example, if the DispID of MyComMethod is 3, you can specify the string "[DispID=3]" instead of "MyComMethod". La chiamata di un membro tramite DispID è più veloce rispetto alla ricerca del membro in base al nome.Invoking a member by DispID is faster than looking up the member by name. Negli scenari di aggregazione complessi, il DispID è talvolta l'unico modo per richiamare il membro desiderato.In complex aggregation scenarios, the DispID is sometimes the only way to invoke the desired member.

Sicurezza

ReflectionPermission
per accedere ai membri non pubblici indipendentemente dal set di concessioni.for accessing non-public members regardless of their grant set. Enumerazione associata:MemberAccessAssociated enumeration: MemberAccess

SecurityPermission
per chiamare codice non gestito.to call unmanaged code. Enumerazione associata:UnmanagedCodeAssociated enumeration: UnmanagedCode

Vedi anche

• String
• Binder
• DefaultBinder
• BindingFlags
• ParameterModifier
• ParameterAttributes
• CultureInfo
• ReflectionPermission

Chiama il membro specificato, usando i vincoli di binding specificati e associando l'elenco di argomenti specificati e le impostazioni cultura.Invokes the specified member, using the specified binding constraints and matching the specified argument list and culture.

public:
 virtual System::Object ^ InvokeMember(System::String ^ name, System::Reflection::BindingFlags invokeAttr, System::Reflection::Binder ^ binder, System::Object ^ target, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture);

public object InvokeMember (string name, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder binder, object target, object[] args, System.Globalization.CultureInfo culture);

abstract member InvokeMember : string * System.Reflection.BindingFlags * System.Reflection.Binder * obj * obj[] * System.Globalization.CultureInfo -> obj
override this.InvokeMember : string * System.Reflection.BindingFlags * System.Reflection.Binder * obj * obj[] * System.Globalization.CultureInfo -> obj

Parametri

Restituisce

Implementazioni

Eccezioni

Commenti

Sebbene il Binder CultureInfo predefinito non elabori (il culture parametro), è possibile usare la classe astratta System.Reflection.Binder per scrivere un gestore di associazione personalizzato che esegue culturel'elaborazione.Although the default binder does not process CultureInfo (the culture parameter), you can use the abstract System.Reflection.Binder class to write a custom binder that does process culture.

I flag BindingFlags di filtro seguenti possono essere usati per definire i membri da includere nella ricerca:The following BindingFlags filter flags can be used to define which members to include in the search:

• Consente BindingFlags.Public di specificare di includere i membri pubblici nella ricerca.Specify BindingFlags.Public to include public members in the search.

• Specificare BindingFlags.NonPublic per includere i membri non pubblici (ovvero i membri privati, interni e protetti) nella ricerca.Specify BindingFlags.NonPublic to include non-public members (that is, private, internal, and protected members) in the search.

• Specificare BindingFlags.FlattenHierarchy per includere i membri statici nella gerarchia.Specify BindingFlags.FlattenHierarchy to include static members up the hierarchy.

I flag BindingFlags di modifica seguenti possono essere utilizzati per modificare il funzionamento della ricerca:The following BindingFlags modifier flags can be used to change how the search works:

• BindingFlags.IgnoreCaseper ignorare la distinzione tra namemaiuscole e minuscole.BindingFlags.IgnoreCase to ignore the case of name.

• BindingFlags.DeclaredOnlyper cercare solo i membri dichiarati Typein, non i membri che sono stati semplicemente ereditati.BindingFlags.DeclaredOnly to search only the members declared on the Type, not members that were simply inherited.

I flag BindingFlags di chiamata seguenti possono essere usati per indicare l'azione da eseguire con il membro:The following BindingFlags invocation flags can be used to denote what action to take with the member:

• CreateInstanceper richiamare un costruttore.CreateInstance to invoke a constructor. nameviene ignorato.name is ignored. Non valido con altri flag di chiamata.Not valid with other invocation flags.

• InvokeMethodper richiamare un metodo, ma non un costruttore o un inizializzatore di tipo.InvokeMethod to invoke a method, but not a constructor or a type initializer. Non valido con SetField o SetProperty.Not valid with SetField or SetProperty. Se InvokeMethod viene specificato da solo BindingFlags.Instance, BindingFlags.Public, e BindingFlags.Static vengono inclusi automaticamente.If InvokeMethod is specified by itself, BindingFlags.Public, BindingFlags.Instance, and BindingFlags.Static are automatically included.

• GetFieldper ottenere il valore di un campo.GetField to get the value of a field. Non valido con SetField.Not valid with SetField.

• SetFieldper impostare il valore di un campo.SetField to set the value of a field. Non valido con GetField.Not valid with GetField.

• GetPropertyper ottenere una proprietà.GetProperty to get a property. Non valido con SetProperty.Not valid with SetProperty.

• SetPropertyper impostare una proprietà.SetProperty to set a property. Non valido con GetProperty.Not valid with GetProperty.

Per altre informazioni, vedere System.Reflection.BindingFlags.See System.Reflection.BindingFlags for more information.

Viene richiamato un metodo se si verificano entrambe le condizioni seguenti:A method will be invoked if both of the following conditions are true:

• Il numero di parametri nella dichiarazione di metodo è uguale al numero di argomenti nella args matrice (a meno che non siano definiti argomenti predefiniti per il membro e BindingFlags.OptionalParamBinding che sia specificato).The number of parameters in the method declaration equals the number of arguments in the args array (unless default arguments are defined on the member and BindingFlags.OptionalParamBinding is specified).

• Il tipo di ogni argomento può essere convertito dal gestore di associazione al tipo del parametro.The type of each argument can be converted by the binder to the type of the parameter.

Il Binder troverà tutti i metodi corrispondenti.The binder will find all of the matching methods. Questi metodi si basano sul tipo di binding richiesto (BindingFlags valori InvokeMethod, GetPropertye così via).These methods are found based upon the type of binding requested (BindingFlags values InvokeMethod, GetProperty, and so on). Il set di metodi viene filtrato in base al nome, al numero di argomenti e a un set di modificatori di ricerca definiti nel gestore di associazione.The set of methods is filtered by the name, number of arguments, and a set of search modifiers defined in the binder.

Una volta selezionato, il metodo viene richiamato.After the method is selected, it is invoked. L'accessibilità viene controllata a questo punto.Accessibility is checked at that point. La ricerca può controllare il set di metodi in base all'attributo di accessibilità associato al metodo.The search may control which set of methods are searched based upon the accessibility attribute associated with the method. Il Binder.BindToMethod metodoBinder della classe è responsabile della selezione del metodo da richiamare.The Binder.BindToMethod method of the Binder class is responsible for selecting the method to be invoked. Il binder predefinito seleziona la corrispondenza più specifica.The default binder selects the most specific match.

Le restrizioni di accesso vengono ignorate per il codice completamente attendibile; ovvero, i costruttori privati, i metodi, i campi e le proprietà possono essere accessibili e richiamati tramite reflection ogni volta che il codice è completamente attendibile.Access restrictions are ignored for fully trusted code; that is, private constructors, methods, fields, and properties can be accessed and invoked through Reflection whenever the code is fully trusted.

È possibile utilizzare Type.InvokeMember per impostare un campo su un valore specifico specificando BindingFlags.SetField.You can use Type.InvokeMember to set a field to a particular value by specifying BindingFlags.SetField. Se, ad esempio, si vuole impostare un campo di istanza pubblica denominato F nella classe C e f è un String , è possibile usare codice come il seguente:For example, if you want to set a public instance field named F on class C, and F is a String you can use code such as:

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {"strings new value"}, null);

Se F è un String[], è possibile usare codice come il seguente:If F is a String[], you can use code such as:

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {new String[]{"a","z","c","d"}}, null);

che consente di inizializzare il campo F nella nuova matrice.which will initialize the field F to this new array. È anche possibile usare Type.InvokeMember per impostare una posizione in una matrice fornendo l'indice del valore e quindi il valore successivo usando un codice simile al seguente:You can also use Type.InvokeMember to set a position in an array by supplying the index of the value and then the next value by using code such as the following:

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {1, "b"}, null);

In questo modo verrà modificata la stringa "z" nella matrice che F viene mantenuta nella stringa "b".This will change string "z" in the array that F holds to string "b".

Quando si richiama un IDispatch membro è possibile specificare il DISPID anziché il nome del membro, usando il formato stringa "[DISPID = # #]".When you invoke an IDispatch member you can specify the DispID instead of the member name, using the string format "[DispID=##]". Se, ad esempio, il DispID di MyComMethod è 3, è possibile specificare la stringa "[DispID = 3]" anziché "MyComMethod".For example, if the DispID of MyComMethod is 3, you can specify the string "[DispID=3]" instead of "MyComMethod". La chiamata di un membro tramite DispID è più veloce rispetto alla ricerca del membro in base al nome.Invoking a member by DispID is faster than looking up the member by name. Negli scenari di aggregazione complessi, il DispID è talvolta l'unico modo per richiamare il membro desiderato.In complex aggregation scenarios, the DispID is sometimes the only way to invoke the desired member.

Sicurezza

ReflectionPermission
per accedere ai membri non pubblici indipendentemente dal set di concessioni.for accessing non-public members regardless of their grant set. Enumerazione associata:MemberAccessAssociated enumeration: MemberAccess

SecurityPermission
per chiamare codice non gestito.to call unmanaged code. Enumerazione associata:UnmanagedCodeAssociated enumeration: UnmanagedCode

Vedi anche

• String
• Binder
• DefaultBinder
• BindingFlags
• ParameterModifier
• ParameterAttributes
• CultureInfo
• ReflectionPermission