Type.InvokeMember Method

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

Public MustOverride Function InvokeMember (name As String, invokeAttr As BindingFlags, binder As Binder, target As Object, args As Object(), modifiers As ParameterModifier(), culture As CultureInfo, namedParameters As String()) As Object

Parameters

Returns

Object

Oggetto che rappresenta il valore restituito di un membro richiamato.An object representing the return value of the invoked member.

Implements

Exceptions

Remarks

InvokeMember chiama 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 membro IDispatch è 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 parametri modifiers 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. ParameterModifier viene utilizzata 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 matrice di namedParameters 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. Ad esempio, dato il metodo M(string a, int b) (M(ByVal a As String, ByVal b As Integer) in Visual Basic) e la matrice di input { 42, "x" }, la matrice di input può essere passata senza modifiche a args se viene fornita la matrice { "b", "a" } per namedParameters.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 di filtro BindingFlags 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:

• Specificare BindingFlags.Public per includere i membri pubblici nella ricerca.Specify BindingFlags.Public to include public members in the search.

• Specificare BindingFlags.NonPublic per includere membri non pubblici (ovvero 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.

Per modificare il funzionamento della ricerca, è possibile utilizzare i flag di modifica BindingFlags seguenti:The following BindingFlags modifier flags can be used to change how the search works:

• BindingFlags.IgnoreCase ignorare il caso di name.BindingFlags.IgnoreCase to ignore the case of name.

• BindingFlags.DeclaredOnly per cercare solo i membri dichiarati nella Type, 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.

Per indicare l'azione da eseguire con il membro, è possibile usare i flag di chiamata seguenti BindingFlags:The following BindingFlags invocation flags can be used to denote what action to take with the member:

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

• InvokeMethod 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 è specificato da solo, BindingFlags.Public, BindingFlags.Instancee BindingFlags.Static vengono inclusi automaticamente.If InvokeMethod is specified by itself, BindingFlags.Public, BindingFlags.Instance, and BindingFlags.Static are automatically included.

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

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

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

• SetProperty 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 matrice di args (a meno che non siano definiti argomenti predefiniti per il membro e BindingFlags.OptionalParamBinding 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 metodo Binder.BindToMethod della classe Binder è 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.

InvokeMember possibile utilizzare 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, è necessario specificare BindingFlags.OptionalParamBinding per 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 oppure specificare 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 si usi Missing.Value, non è possibile omettere i parametri facoltativi con il metodo Invoke.Unless you use Missing.Value, you may not omit optional parameters with the Invoke method. Se necessario, usare invece InvokeMember.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 è una 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".

See also

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

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

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);

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

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

Public Function InvokeMember (name As String, invokeAttr As BindingFlags, binder As Binder, target As Object, args As Object()) As Object

Parameters

Returns

Object

Oggetto che rappresenta il valore restituito di un membro richiamato.An object representing the return value of the invoked member.

Implements

Exceptions

Examples

Nell'esempio seguente viene usato InvokeMember 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

Remarks

I flag di filtro BindingFlags 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:

• Specificare BindingFlags.Public per 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.

Per modificare il funzionamento della ricerca, è possibile utilizzare i flag di modifica BindingFlags seguenti:The following BindingFlags modifier flags can be used to change how the search works:

• BindingFlags.IgnoreCase ignorare il caso di name.BindingFlags.IgnoreCase to ignore the case of name.

• BindingFlags.DeclaredOnly per cercare solo i membri dichiarati nella Type, 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.

Per indicare l'azione da eseguire con il membro, è possibile usare i flag di chiamata seguenti BindingFlags:The following BindingFlags invocation flags can be used to denote what action to take with the member:

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

• InvokeMethod 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 è specificato da solo, BindingFlags.Public, BindingFlags.Instancee BindingFlags.Static vengono inclusi automaticamente.If InvokeMethod is specified by itself, BindingFlags.Public, BindingFlags.Instance, and BindingFlags.Static are automatically included.

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

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

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

• SetProperty 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 matrice di args (a meno che non siano definiti argomenti predefiniti per il membro e BindingFlags.OptionalParamBinding 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 metodo Binder.BindToMethod della classe Binder è 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 è una 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 membro IDispatch, è 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.

See also

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

public:
 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:
 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);

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

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

Public Function InvokeMember (name As String, invokeAttr As BindingFlags, binder As Binder, target As Object, args As Object(), culture As CultureInfo) As Object

Parameters

Returns

Object

Oggetto che rappresenta il valore restituito di un membro richiamato.An object representing the return value of the invoked member.

Implements

Exceptions

Remarks

Sebbene il binder predefinito non elabori CultureInfo (il culture parametro), è possibile usare la classe abstract System.Reflection.Binder per scrivere un gestore di associazione personalizzato che elabora culture.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 di filtro BindingFlags 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:

• Specificare BindingFlags.Public per includere i membri pubblici nella ricerca.Specify BindingFlags.Public to include public members in the search.

• Specificare BindingFlags.NonPublic per includere membri non pubblici (ovvero 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.

Per modificare il funzionamento della ricerca, è possibile utilizzare i flag di modifica BindingFlags seguenti:The following BindingFlags modifier flags can be used to change how the search works:

• BindingFlags.IgnoreCase ignorare il caso di name.BindingFlags.IgnoreCase to ignore the case of name.

• BindingFlags.DeclaredOnly per cercare solo i membri dichiarati nella Type, 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.

Per indicare l'azione da eseguire con il membro, è possibile usare i flag di chiamata seguenti BindingFlags:The following BindingFlags invocation flags can be used to denote what action to take with the member:

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

• InvokeMethod 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 è specificato da solo, BindingFlags.Public, BindingFlags.Instancee BindingFlags.Static vengono inclusi automaticamente.If InvokeMethod is specified by itself, BindingFlags.Public, BindingFlags.Instance, and BindingFlags.Static are automatically included.

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

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

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

• SetProperty 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 matrice di args (a meno che non siano definiti argomenti predefiniti per il membro e BindingFlags.OptionalParamBinding 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 metodo Binder.BindToMethod della classe Binder è 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. Ad esempio, se si desidera impostare un campo di istanza pubblico denominato F nella classe C e F è un String è possibile utilizzare codice come: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 è una 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 membro IDispatch è 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.

See also

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