Type.GetConstructors Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Ottiene i costruttori dell'oggetto Type corrente.

Overload

GetConstructors()	Restituisce tutti i costruttori di tipo pubblico definiti per l'oggetto Type corrente.
GetConstructors(BindingFlags)	Quando ne viene eseguito l'override in una classe derivata, cerca i costruttori definiti per l'oggetto Type corrente, usando i BindingFlags specificati.

Esempio

In questo esempio viene illustrato l'output dell'overload GetConstructors() da una classe con due costruttori di istanza e un costruttore statico.

using namespace System;
using namespace System::Reflection;
public ref class t
{
public:
   t(){}

   static t(){}

   t( int /*i*/ ){}

};

int main()
{
   array<ConstructorInfo^>^p = t::typeid->GetConstructors();
   Console::WriteLine( p->Length );
   for ( int i = 0; i < p->Length; i++ )
   {
      Console::WriteLine( p[ i ]->IsStatic );

   }
}

using System;
using System.Reflection;

public class t {
    public t() {}
    static t() {}
    public t(int i) {}

    public static void Main() {
        ConstructorInfo[] p = typeof(t).GetConstructors();
        Console.WriteLine(p.Length);

        for (int i=0;i<p.Length;i++) {
            Console.WriteLine(p[i].IsStatic);
        }
    }
}

type t() =
    static do ()
    new(i: int) = t ()

let p = typeof<t>.GetConstructors()
printfn $"{p.Length}"

for c in p do
    printfn $"{c.IsStatic}"

Imports System.Reflection

Public Class t
    
    Public Sub New()
    End Sub
    
    Shared Sub New()
    End Sub
    
    Public Sub New(i As Integer)
    End Sub
     
    Public Shared Sub Main()
        Dim p As ConstructorInfo() = GetType(t).GetConstructors()
        Console.WriteLine(p.Length)
        
        Dim i As Integer
        For i = 0 To p.Length - 1
            Console.WriteLine(p(i).IsStatic)
        Next i
    End Sub
End Class

L'output di questo codice è:

2
False
False

Poiché l'overload GetConstructors usa solo Public e Instance, il costruttore statico non è conteggiato dall'espressione for né valutato da IsStatic.

Per trovare costruttori statici, usare l'overload e passarlo alla combinazione (OR logica) di , BindingFlags.StaticBindingFlags.NonPublic, , BindingFlags.Instance, come illustrato nell'esempio GetConstructors di BindingFlags.Publiccodice seguente:

using namespace System;
using namespace System::Reflection;
public ref class t
{
public:
   t(){}

   t( int /*i*/ ){}

   static t(){}

};

int main()
{
   array<ConstructorInfo^>^p = t::typeid->GetConstructors( static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Static | BindingFlags::NonPublic | BindingFlags::Instance) );
   Console::WriteLine( p->Length );
   for ( int i = 0; i < p->Length; i++ )
   {
      Console::WriteLine( p[ i ]->IsStatic );
   }
}

using System;
using System.Reflection;

public class t {
    public t() {}
    static t() {}
    public t(int i) {}

    public static void Main() {
        ConstructorInfo[] p = typeof(t).GetConstructors(
           BindingFlags.Public | BindingFlags.Static |
           BindingFlags.NonPublic | BindingFlags.Instance);
        Console.WriteLine(p.Length);

        for (int i=0;i<p.Length;i++) {
            Console.WriteLine(p[i].IsStatic);
        }
    }
}

open System.Reflection

type t() =
    static do ()
    new (i: int) = t ()

let p = typeof<t>.GetConstructors(BindingFlags.Public ||| BindingFlags.Static ||| BindingFlags.NonPublic ||| BindingFlags.Instance)
printfn $"{p.Length}"

for c in p do
    printfn $"{c.IsStatic}"

Imports System.Reflection

Public Class t
    
    Public Sub New()
    End Sub
    
    Shared Sub New()
    End Sub
    
    Public Sub New(i As Integer)
    End Sub
     
    Public Shared Sub Main()
        Dim p As ConstructorInfo() = GetType(T).GetConstructors( _
           BindingFlags.Public Or _
           BindingFlags.Static Or _
           BindingFlags.NonPublic Or _
           BindingFlags.Instance)
        Console.WriteLine(p.Length)
        
        Dim i As Integer
        For i = 0 To p.Length - 1
            Console.WriteLine(p(i).IsStatic)
        Next i
    End Sub
End Class

Ora l'output è:

3
False
True
False

GetConstructors()

Origine:

Type.cs

Restituisce tutti i costruttori di tipo pubblico definiti per l'oggetto Type corrente.

public:
 cli::array <System::Reflection::ConstructorInfo ^> ^ GetConstructors();

public System.Reflection.ConstructorInfo[] GetConstructors ();

member this.GetConstructors : unit -> System.Reflection.ConstructorInfo[]

Public Function GetConstructors () As ConstructorInfo()

Restituisce

ConstructorInfo[]

Matrice di oggetti ConstructorInfo che rappresentano tutti i costruttori di istanza pubblici definiti per l'oggetto Type corrente, senza l'inizializzatore di tipo (costruttore statico). Se per l'oggetto Type corrente non sono definiti costruttori di istanza pubblici o se l'oggetto Type corrente rappresenta un parametro di tipo nella definizione di un tipo o di un metodo generico, viene restituita una matrice vuota di tipo ConstructorInfo.

Commenti

Nelle versioni precedenti e .NET 6 il metodo non restituisce costruttori in un determinato ordine, ad esempio l'ordine GetConstructors di dichiarazione. Il codice non deve dipendere dall'ordine in cui vengono restituiti i costruttori, perché tale ordine varia. Tuttavia, a partire da .NET 7, l'ordinamento è deterministico in base all'ordinamento dei metadati nell'assembly.

Nella tabella seguente vengono illustrati i membri di una classe base restituiti dai Get metodi quando si riflette su un tipo.

Tipo di membro	Static	Non statico
Costruttore	No	No
Campo	No	Sì. Un campo è sempre hide-by-name-and-signature.
Evento	Non applicabile	La regola di sistema dei tipi comune è che l'ereditarietà è uguale a quella dei metodi che implementano la proprietà. Reflection tratta le proprietà come hide-by-name-and-signature. Vedere la nota 2 seguente.
Metodo	No	Sì. Un metodo (sia virtuale che non virtuale) può essere hide-by-name o hide-by-name-and-signature.
Tipo annidato	No	No
Proprietà	Non applicabile	La regola di sistema dei tipi comune è che l'ereditarietà è uguale a quella dei metodi che implementano la proprietà. Reflection tratta le proprietà come hide-by-name-and-signature. Vedere la nota 2 seguente.

1. Hide-by-name-and-signature considera tutte le parti della firma, inclusi modificatori personalizzati, tipi restituiti, tipi di parametri, sentinelle e convenzioni di chiamata non gestite. Si tratta di un confronto binario.

2. Per la reflection, le proprietà e gli eventi sono nascondi per nome e firma. Se si dispone di una proprietà con una funzione di accesso get e un set nella classe base, ma la classe derivata ha solo una funzione di accesso get, la proprietà classe derivata nasconde la proprietà della classe base e non sarà possibile accedere al setter nella classe base.

3. Gli attributi personalizzati non fanno parte del sistema di tipi comuni.

Questo metodo esegue l'overload del GetConstructors(BindingFlags) metodo con BindingFlags.PublicBindingFlags.Instance | (BindingFlags.PublicOrBindingFlags.Instance in Visual Basic). Non troverà inizializzatori di classe (costruttore statico). Per trovare inizializzatori di classi, usare un overload che accetta BindingFlagse specifica (BindingFlags.StaticBindingFlags.NonPublicBindingFlags.Static | BindingFlags.NonPublicOrin Visual Basic). È anche possibile ottenere l'inizializzatore di classe usando la TypeInitializer proprietà .

Se l'oggetto corrente Type rappresenta un tipo generico costruito, questo metodo restituisce gli oggetti con i ConstructorInfo parametri di tipo sostituiti dagli argomenti di tipo appropriati. Ad esempio, se la classe C<T> ha un costruttore C(T t1) ( in Visual Basic), la chiamata GetConstructors su C<int> restituisce un ConstructorInfo oggetto che rappresenta C(int t1) in C# (Sub New(ByVal t1 As T)Sub New(ByVal t1 As Integer) in Visual Basic).

Se l'oggetto corrente Type rappresenta un parametro di tipo generico, il GetConstructors metodo restituisce una matrice vuota.

Vedi anche

• ConstructorInfo
• GetConstructor(BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])

GetConstructors(BindingFlags)

Origine:

Type.cs

Quando ne viene eseguito l'override in una classe derivata, cerca i costruttori definiti per l'oggetto Type corrente, usando i BindingFlags specificati.

public:
 abstract cli::array <System::Reflection::ConstructorInfo ^> ^ GetConstructors(System::Reflection::BindingFlags bindingAttr);

public abstract System.Reflection.ConstructorInfo[] GetConstructors (System.Reflection.BindingFlags bindingAttr);

abstract member GetConstructors : System.Reflection.BindingFlags -> System.Reflection.ConstructorInfo[]

Public MustOverride Function GetConstructors (bindingAttr As BindingFlags) As ConstructorInfo()

Parametri

bindingAttr

BindingFlags

Combinazione bit per bit di valori di enumerazione che specifica il modo in cui viene eseguita la ricerca.

-oppure-

Default per restituire una matrice vuota.

Restituisce

ConstructorInfo[]

Matrice di ConstructorInfo oggetti che rappresentano tutti i costruttori definiti per l'oggetto corrente Type che corrispondono ai vincoli di associazione specificati, incluso l'inizializzatore di tipi se è definito. Restituisce una matrice vuota di tipo ConstructorInfo se per l'oggetto Type corrente non sono definiti costruttori, se nessuno dei costruttori definiti corrisponde ai vincoli di associazione o se l'oggetto Type corrente rappresenta un parametro di tipo nella definizione di un tipo o di un metodo generico.

Commenti

bindingAttr può essere usato per specificare se restituire solo costruttori pubblici o sia costruttori pubblici che non pubblici.

I flag di filtro seguenti BindingFlags possono essere usati per definire quali costruttori includere nella ricerca:

• Specificare BindingFlags.Static insieme BindingFlags.NonPublic a per recuperare l'inizializzatore di classe (costruttore statico). È anche possibile ottenere l'inizializzatore di classe usando la TypeInitializer proprietà .

• Specificare BindingFlags.Instance insieme a uno o entrambi e BindingFlags.NonPublic per recuperare i costruttori di BindingFlags.Public istanze.

Per altre informazioni, vedere System.Reflection.BindingFlags.

Nelle versioni precedenti e .NET 6 il metodo non restituisce costruttori in un determinato ordine, ad esempio l'ordine GetConstructors di dichiarazione. Il codice non deve dipendere dall'ordine in cui vengono restituiti i costruttori, perché tale ordine varia. Tuttavia, a partire da .NET 7, l'ordinamento è deterministico in base all'ordinamento dei metadati nell'assembly.

Se l'oggetto corrente Type rappresenta un tipo generico costruito, questo metodo restituisce gli oggetti con i ConstructorInfo parametri di tipo sostituiti dagli argomenti di tipo appropriati. Ad esempio, se la classe C<T> ha un costruttore C(T t1) ( in Visual Basic), la chiamata GetConstructors su C<int> restituisce un ConstructorInfo oggetto che rappresenta C(int t1) in C# (Sub New(ByVal t1 As T)Sub New(ByVal t1 As Integer) in Visual Basic).

Se l'oggetto corrente Type rappresenta un parametro di tipo generico, il GetConstructors metodo restituisce una matrice vuota.

Vedi anche

• ConstructorInfo
• BindingFlags
• DefaultBinder
• GetConstructor(BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])