ConstructorInfo Classe

Definição

Namespace:

System.Reflection

Assembly:

System.Runtime.dll

Origem:

ConstructorInfo.cs

Descobre os atributos de um construtor de classe e fornece acesso aos metadados do construtor.

public ref class ConstructorInfo abstract : System::Reflection::MethodBase

public abstract class ConstructorInfo : System.Reflection.MethodBase

type ConstructorInfo = class
    inherit MethodBase

Public MustInherit Class ConstructorInfo
Inherits MethodBase

Herança

Object

MemberInfo

MethodBase

ConstructorInfo

Derivado

Microsoft.JScript.JSConstructor

System.Reflection.Emit.ConstructorBuilder

Exemplos

O exemplo a seguir usa ConstructorInfo com GetConstructor e BindingFlags para localizar os construtores que correspondem aos critérios de pesquisa especificados.

using namespace System;
using namespace System::Reflection;
using namespace System::Security;
public ref class MyClass1
{
public:
   MyClass1( int i ){}

};

int main()
{
   try
   {
      Type^ myType = MyClass1::typeid;
      array<Type^>^types = gcnew array<Type^>(1);
      types[ 0 ] = int::typeid;
      
      // Get the public instance constructor that takes an integer parameter.
      ConstructorInfo^ constructorInfoObj = myType->GetConstructor( static_cast<BindingFlags>(BindingFlags::Instance | BindingFlags::Public), nullptr, CallingConventions::HasThis, types, nullptr );
      if ( constructorInfoObj != nullptr )
      {
         Console::WriteLine( "The constructor of MyClass1 that is a public instance method and takes an integer as a parameter is: " );
         Console::WriteLine( constructorInfoObj );
      }
      else
      {
         Console::WriteLine( "The constructor of MyClass1 that is a public instance method and takes an integer as a parameter is not available." );
      }
   }
   catch ( ArgumentNullException^ e ) 
   {
      Console::WriteLine( "ArgumentNullException: {0}", e->Message );
   }
   catch ( ArgumentException^ e ) 
   {
      Console::WriteLine( "ArgumentException: {0}", e->Message );
   }
   catch ( SecurityException^ e ) 
   {
      Console::WriteLine( "SecurityException: {0}", e->Message );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception: {0}", e->Message );
   }
}

using System;
using System.Reflection;
using System.Security;

public class MyClass3
{
    public MyClass3(int i) { }
    public static void Main()
    {
        try
        {
            Type myType = typeof(MyClass3);
            Type[] types = new Type[1];
            types[0] = typeof(int);
            // Get the public instance constructor that takes an integer parameter.
            ConstructorInfo constructorInfoObj = myType.GetConstructor(
                BindingFlags.Instance | BindingFlags.Public, null,
                CallingConventions.HasThis, types, null);
            if (constructorInfoObj != null)
            {
                Console.WriteLine("The constructor of MyClass3 that is a public " +
                    "instance method and takes an integer as a parameter is: ");
                Console.WriteLine(constructorInfoObj.ToString());
            }
            else
            {
                Console.WriteLine("The constructor of MyClass3 that is a public instance " +
                    "method and takes an integer as a parameter is not available.");
            }
        }
        catch (ArgumentNullException e)
        {
            Console.WriteLine("ArgumentNullException: " + e.Message);
        }
        catch (ArgumentException e)
        {
            Console.WriteLine("ArgumentException: " + e.Message);
        }
        catch (SecurityException e)
        {
            Console.WriteLine("SecurityException: " + e.Message);
        }
        catch (Exception e)
        {
            Console.WriteLine("Exception: " + e.Message);
        }
    }
}

Public Class MyClass1
    Public Sub New(ByVal i As Integer)
    End Sub
    Public Shared Sub Main()
        Try
            Dim myType As Type = GetType(MyClass1)
            Dim types(0) As Type
            types(0) = GetType(Integer)
            ' Get the public instance constructor that takes an integer parameter.
            Dim constructorInfoObj As ConstructorInfo = _
                        myType.GetConstructor(BindingFlags.Instance Or _
                        BindingFlags.Public, Nothing, _
                        CallingConventions.HasThis, types, Nothing)
            If Not (constructorInfoObj Is Nothing) Then
                Console.WriteLine("The constructor of MyClass1 that " + _
                                  "is a public instance method and takes an " + _
                                  "integer as a parameter is: ")
                Console.WriteLine(constructorInfoObj.ToString())
            Else
                Console.WriteLine("The constructor MyClass1 that " + _
                                  "is a public instance method and takes an " + _
                                  "integer as a parameter is not available.")
            End If
        Catch e As ArgumentNullException
            Console.WriteLine("ArgumentNullException: " + e.Message)
        Catch e As ArgumentException
            Console.WriteLine("ArgumentException: " + e.Message)
        Catch e As SecurityException
            Console.WriteLine("SecurityException: " + e.Message)
        Catch e As Exception
            Console.WriteLine("Exception: " + e.Message)
        End Try
    End Sub
End Class

Comentários

ConstructorInfo é usado para descobrir os atributos de um construtor, bem como para invocar um construtor. Os objetos são criados chamando Invoke em um ConstructorInfo retornado pelo GetConstructors método ou GetConstructor de um Type objeto .

Observação

ConstructorInfo herda de MethodBase vários membros, como IsGenericMethod, que podem ser usados para examinar métodos genéricos. No .NET Framework construtores versão 2.0 não podem ser genéricos, portanto, esses membros retornam false ou null.

Notas aos Implementadores

Ao herdar de ConstructorInfo, você deve substituir a seguinte sobrecarga de membro: Invoke(BindingFlags, Binder, Object[], CultureInfo).

Construtores

ConstructorInfo()

Inicializa uma nova instância da classe ConstructorInfo.

Campos

ConstructorName	Representa o nome do método de construtor da classe conforme ele é armazenado nos metadados. Esse nome é sempre ".ctor". Este campo é somente leitura.
TypeConstructorName	Representa o nome do método de construtor de tipo conforme ele é armazenado nos metadados. Esse nome é sempre ".cctor". Esta propriedade é somente para leitura.

Propriedades

Attributes	Obtém os atributos associados a esse método. (Herdado de MethodBase)
CallingConvention	Obtém um valor que indica as convenções de chamada deste método. (Herdado de MethodBase)
ContainsGenericParameters	Obtém um valor que indica se o método genérico contém parâmetros de tipo genérico não atribuídos. (Herdado de MethodBase)
CustomAttributes	Obtém uma coleção que contém os atributos personalizados desse membro. (Herdado de MemberInfo)
DeclaringType	Obtém a classe que declara esse membro. (Herdado de MemberInfo)
IsAbstract	Obtém um valor que indica se o método é abstrato. (Herdado de MethodBase)
IsAssembly	Obtém um valor que indica se a visibilidade potencial deste método ou construtor é descrita por Assembly; ou seja, o construtor ou método é visível no máximo para outros tipos no mesmo assembly e não é visível a tipos derivados fora do assembly. (Herdado de MethodBase)
IsCollectible	Obtém um valor que indica se este objeto MemberInfo faz parte de um assembly mantido em uma coleção AssemblyLoadContext. (Herdado de MemberInfo)
IsConstructedGenericMethod	Descobre os atributos de um construtor de classe e fornece acesso aos metadados do construtor. (Herdado de MethodBase)
IsConstructor	Obtém um valor que indica se o método é um construtor. (Herdado de MethodBase)
IsFamily	Obtém um valor que indica se a visibilidade deste método ou construtor é descrita por Family; ou seja, o método ou o construtor é visível somente dentro de sua classe e de classes derivadas. (Herdado de MethodBase)
IsFamilyAndAssembly	Obtém um valor que indica se a visibilidade deste método ou construtor é descrita por FamANDAssem; ou seja, o método ou o construtor pode ser chamado por classes derivadas, mas apenas se estiverem no mesmo assembly. (Herdado de MethodBase)
IsFamilyOrAssembly	Obtém um valor que indica se a visibilidade potencial deste método ou construtor é descrita por FamORAssem; ou seja, o método ou o construtor pode ser chamado por classes derivadas, não importa em que lugar elas estejam e por classes no mesmo assembly. (Herdado de MethodBase)
IsFinal	Obtém um valor que indica se esse método é final. (Herdado de MethodBase)
IsGenericMethod	Obtém um valor que indica se o método é genérico. (Herdado de MethodBase)
IsGenericMethodDefinition	Obtém um valor que indica se o método é uma definição de método genérica. (Herdado de MethodBase)
IsHideBySig	Obtém um valor que indica se apenas um membro do mesmo tipo, com exatamente a mesma assinatura, está oculto na classe derivada. (Herdado de MethodBase)
IsPrivate	Obtém um valor que indica se este membro é privado. (Herdado de MethodBase)
IsPublic	Obtém um valor que indica se este é um método público. (Herdado de MethodBase)
IsSecurityCritical	Obtém um valor que indica se o método ou o construtor atual é crítico para segurança ou crítico para segurança e disponível no código transparente no nível de confiança atual e, portanto, pode realizar operações críticas. (Herdado de MethodBase)
IsSecuritySafeCritical	Obtém um valor que indica se o método ou o construtor atual é crítico para segurança e disponível no código transparente no nível de confiança atual; ou seja, se ele pode realizar operações críticas e ser acessado pelo código transparente. (Herdado de MethodBase)
IsSecurityTransparent	Obtém um valor que indica que se o método ou o construtor atual é transparente no nível de confiança atual e, portanto, não é pode realizar operações críticas. (Herdado de MethodBase)
IsSpecialName	Obtém um valor que indica se esse método tem um nome especial. (Herdado de MethodBase)
IsStatic	Obtém um valor que indica se o método é static. (Herdado de MethodBase)
IsVirtual	Obtém um valor que indica se o método é virtual. (Herdado de MethodBase)
MemberType	Obtém um valor MemberTypes que indica que esse membro é um construtor.
MetadataToken	Obtém um valor que identifica um elemento de metadados. (Herdado de MemberInfo)
MethodHandle	Obtém um identificador para a representação interna de metadados de um método. (Herdado de MethodBase)
MethodImplementationFlags	Obtém os sinalizadores MethodImplAttributes que especificam os atributos de uma implementação de método. (Herdado de MethodBase)
Module	Obtém o módulo no qual o tipo que declara o membro representado pelo MemberInfo atual está definido. (Herdado de MemberInfo)
Name	Obtém o nome do membro atual. (Herdado de MemberInfo)
ReflectedType	Obtém o objeto de classe que foi usado para obter esta instância de MemberInfo. (Herdado de MemberInfo)

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado.
GetCustomAttributes(Boolean)	Quando substituído em uma classe derivada, retorna uma matriz de todos os atributos personalizados aplicados a esse membro. (Herdado de MemberInfo)
GetCustomAttributes(Type, Boolean)	Quando substituído em uma classe derivada, retorna uma matriz de atributos personalizados aplicados a esse membro e identificados por Type. (Herdado de MemberInfo)
GetCustomAttributesData()	Retorna uma lista de objetos CustomAttributeData que representam dados sobre os atributos que foram aplicados ao membro de destino. (Herdado de MemberInfo)
GetGenericArguments()	Retorna uma matriz de objetos Type que representam os argumentos de tipo de um método genérico ou os parâmetros de tipo de uma definição de método genérico. (Herdado de MethodBase)
GetHashCode()	Retorna o código hash para a instância.
GetMethodBody()	Quando substituído em uma classe derivada, obtém um objeto MethodBody que fornece acesso ao fluxo MSIL, variáveis locais e exceções para o método atual. (Herdado de MethodBase)
GetMethodImplementationFlags()	Quando substituído em uma classe derivada, retorna os sinalizadores MethodImplAttributes. (Herdado de MethodBase)
GetParameters()	Quando substituído em uma classe derivada, obtém os parâmetros do método ou do construtor especificado. (Herdado de MethodBase)
GetType()	Descobre os atributos de um construtor de classe e fornece acesso aos metadados do construtor. (Herdado de MethodBase)
HasSameMetadataDefinitionAs(MemberInfo)	Descobre os atributos de um construtor de classe e fornece acesso aos metadados do construtor. (Herdado de MemberInfo)
Invoke(BindingFlags, Binder, Object[], CultureInfo)	Quando implementado em uma classe derivada, invoca o construtor refletido por este ConstructorInfo com os argumentos especificados, sob as restrições do Binder especificado.
Invoke(Object, BindingFlags, Binder, Object[], CultureInfo)	Quando substituído em uma classe derivada, invoca o método ou o construtor refletido com parâmetros especificados. (Herdado de MethodBase)
Invoke(Object, Object[])	Invoca o método ou o construtor representado pela instância atual, usando os parâmetros especificados. (Herdado de MethodBase)
Invoke(Object[])	Invoca o construtor refletido pela instância que tem os parâmetros especificados, fornecendo valores padrão para os parâmetros que não são usados normalmente.
IsDefined(Type, Boolean)	Quando substituído em uma classe derivada, indica se um ou mais atributos do tipo especificado ou de seus tipos derivados são aplicados a esse membro. (Herdado de MemberInfo)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Operadores

Equality(ConstructorInfo, ConstructorInfo)	Indica se dois objetos ConstructorInfo são iguais.
Inequality(ConstructorInfo, ConstructorInfo)	Indica se dois objetos ConstructorInfo não são iguais.

Métodos de Extensão

GetCustomAttribute(MemberInfo, Type)	Recupera um atributo personalizado de um tipo especificado aplicado a um membro especificado.
GetCustomAttribute(MemberInfo, Type, Boolean)	Recupera um atributo personalizado de um tipo especificado aplicado a um membro especificado e opcionalmente inspeciona os ancestrais desse membro.
GetCustomAttribute<T>(MemberInfo)	Recupera um atributo personalizado de um tipo especificado aplicado a um membro especificado.
GetCustomAttribute<T>(MemberInfo, Boolean)	Recupera um atributo personalizado de um tipo especificado aplicado a um membro especificado e opcionalmente inspeciona os ancestrais desse membro.
GetCustomAttributes(MemberInfo)	Recupera uma coleção de atributos personalizados que são aplicados a um membro especificado.
GetCustomAttributes(MemberInfo, Boolean)	Recupera uma coleção de atributos personalizados aplicado a um membro especificado e opcionalmente inspeciona os ancestrais desse membro.
GetCustomAttributes(MemberInfo, Type)	Recupera uma coleção de atributos personalizados de um tipo especificado que são aplicados a um membro especificado.
GetCustomAttributes(MemberInfo, Type, Boolean)	Recupera uma coleção de atributos personalizados de um tipo especificado aplicado a um membro especificado e opcionalmente inspeciona os ancestrais desse membro.
GetCustomAttributes<T>(MemberInfo)	Recupera uma coleção de atributos personalizados de um tipo especificado que são aplicados a um membro especificado.
GetCustomAttributes<T>(MemberInfo, Boolean)	Recupera uma coleção de atributos personalizados de um tipo especificado aplicado a um membro especificado e opcionalmente inspeciona os ancestrais desse membro.
IsDefined(MemberInfo, Type)	Indica se os atributos personalizados de um tipo especificados são aplicados a um membro especificado.
IsDefined(MemberInfo, Type, Boolean)	Indica se os atributos personalizados de um tipo especificado são aplicados a um membro especificado e, opcionalmente, aplicados a seus ancestrais.
GetMetadataToken(MemberInfo)	Obtém um token de metadados para o membro fornecido, se disponível.
HasMetadataToken(MemberInfo)	Retorna um valor que indica se um token de metadados está disponível para o membro especificado.

Acesso thread-safe

Este tipo é thread-safe.