Activator.CreateInstance Método

Definição

Cria uma instância do tipo especificado usando o construtor que melhor corresponde aos parâmetros especificados.

Sobrecargas

CreateInstance(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)
Obsoleto.

Cria uma instância do tipo cujo nome é especificado no domínio remoto especificado, usando o assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

CreateInstance(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Cria uma instância do tipo cujo nome é especificado no domínio remoto especificado, usando o assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Cria uma instância do tipo cujo nome é especificado, usando o assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo, Object[])

Cria uma instância do tipo especificado usando o construtor que melhor corresponde aos parâmetros especificados.

CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo)

Cria uma instância do tipo especificado usando o construtor que melhor corresponde aos parâmetros especificados.

CreateInstance(Type, Object[], Object[])

Cria uma instância do tipo especificado usando o construtor que melhor corresponde aos parâmetros especificados.

CreateInstance(String, String, Object[])

Cria uma instância do tipo cujo nome é especificado, usando o assembly nomeado e o construtor sem parâmetros.

CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)
Obsoleto.

Cria uma instância do tipo cujo nome é especificado, usando o assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

CreateInstance(Type, Object[])

Cria uma instância do tipo especificado usando o construtor que melhor corresponde aos parâmetros especificados.

CreateInstance(Type, Boolean)

Cria uma instância do tipo especificado usando o construtor sem parâmetros desse tipo.

CreateInstance(String, String)

Cria uma instância do tipo cujo nome é especificado, usando o assembly nomeado e o construtor sem parâmetros.

CreateInstance(ActivationContext, String[])

Cria uma instância do tipo que é designada pelo objeto ActivationContext especificado e ativada com os dados de ativação personalizados especificados.

CreateInstance(Type)

Cria uma instância do tipo especificado usando o construtor sem parâmetros desse tipo.

CreateInstance(ActivationContext)

Cria uma instância do tipo designado pelo objeto ActivationContext especificado.

CreateInstance(AppDomain, String, String)

Cria uma instância do tipo cujo nome é especificado no domínio remoto especificado, usando o assembly nomeado e o construtor sem parâmetros.

CreateInstance<T>()

Cria uma instância do tipo designado pelo parâmetro de tipo genérico especificado, usando o construtor sem parâmetros.

CreateInstance(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

Cuidado

Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstance which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.

Cria uma instância do tipo cujo nome é especificado no domínio remoto especificado, usando o assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

public static System.Runtime.Remoting.ObjectHandle CreateInstance (AppDomain domain, string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes, System.Security.Policy.Evidence securityAttributes);
[System.Obsolete("Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstance which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstance (AppDomain domain, string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes, System.Security.Policy.Evidence securityAttributes);

Parâmetros

domain
AppDomain

O domínio em que o tipo chamado typeName é criado.

assemblyName
String

O nome do assembly em que o tipo chamado typeName é procurado. Se assemblyName for null, o assembly em execução será pesquisado.

typeName
String

O nome totalmente qualificado do tipo do qual criar uma instância.

ignoreCase
Boolean

true especificar que a pesquisa por typeName não diferencia maiúsculas de minúsculas; false especificar que a pesquisa diferencia maiúsculas de minúsculas.

bindingAttr
BindingFlags

Uma combinação de sinalizadores de zero ou mais bits que afetam a pesquisa do construtor typeName. Se bindingAttr for zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos será realizada.

binder
Binder

Um objeto que usa bindingAttr e args para procurar e identificar o construtor typeName. Se binder for null, o associador padrão será usado.

args
Object[]

Uma matriz de argumentos que correspondem em número, ordem e digite os parâmetros do construtor a ser invocado. Se args for uma matriz vazia ou null, o construtor que não usa parâmetros (o construtor sem parâmetros) será invocado.

culture
CultureInfo

Informações específicas da cultura que regem a coerção de args aos tipos formais declarados para o construtor typeName. Se culture for null, o CultureInfo do thread atual será usado.

activationAttributes
Object[]

Uma matriz de um ou mais atributos que podem participar da ativação. Normalmente, essa é uma matriz que contém um único objeto UrlAttribute. O UrlAttribute especifica a URL necessária para ativar um objeto remoto.

securityAttributes
Evidence

Informações usadas para tomar decisões de política de segurança e conceder permissões de código.

Retornos

Um identificador que deve ser desembrulhado para acessar o objeto recém-criado ou null para instâncias Nullable<T> sem valor.

Atributos

Exceções

domain ou typeName é null.

Nenhum construtor correspondente foi encontrado.

typeName não foi encontrado em assemblyName.

assemblyName não foi encontrado.

O chamador não tem permissão para chamar esse construtor.

Não é possível criar uma instância de uma classe abstrata ou esse membro foi invocado com um mecanismo de associação tardia.

O construtor, que foi invocado por meio da reflexão, lançou uma exceção.

O tipo COM não foi obtido por meio de GetTypeFromProgID ou GetTypeFromCLSID.

Não há suporte para a criação de tipos TypedReference, ArgIterator, Voide RuntimeArgumentHandle ou matrizes desses tipos.

-ou-

activationAttributes não é uma matriz vazia e o tipo que está sendo criado não deriva de MarshalByRefObject.

-ou-

O construtor que melhor corresponde args tem argumentos varargs.

assemblyName não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyName foi compilado para uma versão do CLR posterior à versão carregada no momento. Observe que as versões do .NET Framework 2.0, 3.0 e 3.5 usam clr versão 2.0.

Um assembly ou módulo foi carregado duas vezes com duas evidências diferentes.

-ou-

O nome do assembly ou base de código é inválido.

Comentários

Use CreateInstance quando um host precisar executar código em um domínio de aplicativo que tenha permissões de segurança restritas.

Use ObjectHandle.Unwrap para desembrulhar o valor retornado.

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões (Obsoleto)
.NET Framework 2.0, 3.0, 3.5 (4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1)

CreateInstance(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Cria uma instância do tipo cujo nome é especificado no domínio remoto especificado, usando o assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstance (AppDomain domain, string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);

Parâmetros

domain
AppDomain

O domínio em que o tipo chamado typeName é criado.

assemblyName
String

O nome do assembly em que o tipo chamado typeName é procurado. Se assemblyName for null, o assembly em execução será pesquisado.

typeName
String

O nome totalmente qualificado do tipo do qual criar uma instância.

ignoreCase
Boolean

true especificar que a pesquisa por typeName não diferencia maiúsculas de minúsculas; false especificar que a pesquisa diferencia maiúsculas de minúsculas.

bindingAttr
BindingFlags

Uma combinação de sinalizadores de zero ou mais bits que afetam a pesquisa do construtor typeName. Se bindingAttr for zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos será realizada.

binder
Binder

Um objeto que usa bindingAttr e args para procurar e identificar o construtor typeName. Se binder for null, o associador padrão será usado.

args
Object[]

Uma matriz de argumentos que correspondem em número, ordem e digite os parâmetros do construtor a ser invocado. Se args for uma matriz vazia ou null, o construtor que não usa parâmetros (o construtor sem parâmetros) será invocado.

culture
CultureInfo

Informações específicas da cultura que regem a coerção de args aos tipos formais declarados para o construtor typeName. Se culture for null, o CultureInfo do thread atual será usado.

activationAttributes
Object[]

Uma matriz de um ou mais atributos que podem participar da ativação. Normalmente, essa é uma matriz que contém um único objeto UrlAttribute que especifica a URL necessária para ativar um objeto remoto.

Esse parâmetro está relacionado a objetos ativados pelo cliente. A ativação do cliente é uma tecnologia herdada que é retida para compatibilidade com versões anteriores, mas não é recomendada para o novo desenvolvimento. Em vez disso, os aplicativos distribuídos devem usar o Windows Communication Foundation.

Retornos

Um identificador que deve ser desembrulhado para acessar o objeto recém-criado ou null para instâncias Nullable<T> sem valor.

Atributos

Exceções

domain ou typeName é null.

Nenhum construtor correspondente foi encontrado.

typeName não foi encontrado em assemblyName.

assemblyName não foi encontrado.

O chamador não tem permissão para chamar esse construtor.

Não é possível criar uma instância de uma classe abstrata ou esse membro foi invocado com um mecanismo de associação tardia.

O construtor, que foi invocado por meio da reflexão, lançou uma exceção.

O tipo COM não foi obtido por meio de GetTypeFromProgID ou GetTypeFromCLSID.

Não há suporte para a criação de tipos TypedReference, ArgIterator, Voide RuntimeArgumentHandle ou matrizes desses tipos.

-ou-

activationAttributes não é uma matriz vazia e o tipo que está sendo criado não deriva de MarshalByRefObject.

-ou-

O construtor que melhor corresponde args tem argumentos varargs.

assemblyName não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyName foi compilado para uma versão do CLR posterior à versão carregada no momento. Observe que as versões do .NET Framework 2.0, 3.0 e 3.5 usam clr versão 2.0.

Um assembly ou módulo foi carregado duas vezes com duas evidências diferentes.

-ou-

O nome do assembly ou base de código é inválido.

Comentários

Use CreateInstance quando um host precisar executar código em um domínio de aplicativo que tenha permissões de segurança restritas.

Use ObjectHandle.Unwrap para desembrulhar o valor retornado.

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Origem:
Activator.RuntimeType.cs
Origem:
Activator.RuntimeType.cs
Origem:
Activator.RuntimeType.cs

Cria uma instância do tipo cujo nome é especificado, usando o assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

public static System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);
public static System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);

Parâmetros

assemblyName
String

O nome do assembly em que o tipo chamado typeName é procurado. Se assemblyName for null, o assembly em execução será pesquisado.

typeName
String

O nome totalmente qualificado do tipo do qual criar uma instância.

ignoreCase
Boolean

true especificar que a pesquisa por typeName não diferencia maiúsculas de minúsculas; false especificar que a pesquisa diferencia maiúsculas de minúsculas.

bindingAttr
BindingFlags

Uma combinação de sinalizadores de zero ou mais bits que afetam a pesquisa do construtor typeName. Se bindingAttr for zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos será realizada.

binder
Binder

Um objeto que usa bindingAttr e args para procurar e identificar o construtor typeName. Se binder for null, o associador padrão será usado.

args
Object[]

Uma matriz de argumentos que correspondem em número, ordem e digite os parâmetros do construtor a ser invocado. Se args for uma matriz vazia ou null, o construtor que não usa parâmetros (o construtor sem parâmetros) será invocado.

culture
CultureInfo

Informações específicas da cultura que regem a coerção de args aos tipos formais declarados para o construtor typeName. Se culture for null, o CultureInfo do thread atual será usado.

activationAttributes
Object[]

Uma matriz de um ou mais atributos que podem participar da ativação. Normalmente, essa é uma matriz que contém um único objeto UrlAttribute que especifica a URL necessária para ativar um objeto remoto.

Esse parâmetro está relacionado a objetos ativados pelo cliente. A ativação do cliente é uma tecnologia herdada que é retida para compatibilidade com versões anteriores, mas não é recomendada para o novo desenvolvimento. Em vez disso, os aplicativos distribuídos devem usar o Windows Communication Foundation.

Retornos

Um identificador que deve ser desembrulhado para acessar a instância recém-criada ou null para instâncias Nullable<T> sem valor.

Exceções

typeName é null.

Nenhum construtor correspondente foi encontrado.

typeName não foi encontrado em assemblyName.

assemblyName não foi encontrado.

O chamador não tem permissão para chamar esse construtor.

Não é possível criar uma instância de uma classe abstrata ou esse membro foi invocado com um mecanismo de associação tardia.

O construtor, que foi invocado por meio da reflexão, lançou uma exceção.

O tipo COM não foi obtido por meio de GetTypeFromProgID ou GetTypeFromCLSID.

Não há suporte para a criação de tipos TypedReference, ArgIterator, Voide RuntimeArgumentHandle ou matrizes desses tipos.

-ou-

activationAttributes não é uma matriz vazia e o tipo que está sendo criado não deriva de MarshalByRefObject.

-ou-

O construtor que melhor corresponde args tem argumentos varargs.

assemblyName não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyName foi compilado para uma versão do CLR posterior à versão carregada no momento. Observe que as versões do .NET Framework 2.0, 3.0 e 3.5 usam clr versão 2.0.

Um assembly ou módulo foi carregado duas vezes com duas evidências diferentes.

-ou-

O nome do assembly ou base de código é inválido.

Comentários

Use ObjectHandle.Unwrap para desembrulhar o valor retornado.

Observação

A partir do .NET Framework 2.0, esse método poderá ser usado para criar tipos e membros não públicos se o chamador tiver recebido ReflectionPermission com o sinalizador ReflectionPermissionFlag.RestrictedMemberAccess e se o conjunto de concessões do assembly que contém os tipos e membros não públicos estiver restrito ao conjunto de concessões do chamador ou a um subconjunto dele. (Consulte considerações de segurança para reflexão.) Para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3.5 ou posterior.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo, Object[])

Origem:
Activator.RuntimeType.cs
Origem:
Activator.RuntimeType.cs
Origem:
Activator.RuntimeType.cs

Cria uma instância do tipo especificado usando o construtor que melhor corresponde aos parâmetros especificados.

public static object? CreateInstance (Type type, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);
public static object CreateInstance (Type type, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);

Parâmetros

type
Type

O tipo de objeto a ser criado.

bindingAttr
BindingFlags

Uma combinação de sinalizadores de zero ou mais bits que afetam a pesquisa do construtor type. Se bindingAttr for zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos será realizada.

binder
Binder

Um objeto que usa bindingAttr e args para procurar e identificar o construtor type. Se binder for null, o associador padrão será usado.

args
Object[]

Uma matriz de argumentos que correspondem em número, ordem e digite os parâmetros do construtor a ser invocado. Se args for uma matriz vazia ou null, o construtor que não usa parâmetros (o construtor sem parâmetros) será invocado.

culture
CultureInfo

Informações específicas da cultura que regem a coerção de args aos tipos formais declarados para o construtor type. Se culture for null, o CultureInfo do thread atual será usado.

activationAttributes
Object[]

Uma matriz de um ou mais atributos que podem participar da ativação. Normalmente, essa é uma matriz que contém um único objeto UrlAttribute que especifica a URL necessária para ativar um objeto remoto.

Esse parâmetro está relacionado a objetos ativados pelo cliente. A ativação do cliente é uma tecnologia herdada que é retida para compatibilidade com versões anteriores, mas não é recomendada para o novo desenvolvimento. Em vez disso, os aplicativos distribuídos devem usar o Windows Communication Foundation.

Retornos

Uma referência ao objeto recém-criado ou null para instâncias Nullable<T> sem valor.

Exceções

type é null.

type não é um RuntimeType.

-ou-

type é um tipo genérico aberto (ou seja, a propriedade ContainsGenericParameters retorna true).

type não pode ser um TypeBuilder.

-ou-

Não há suporte para a criação de tipos TypedReference, ArgIterator, Voide RuntimeArgumentHandle ou matrizes desses tipos.

-ou-

activationAttributes não é uma matriz vazia e o tipo que está sendo criado não deriva de MarshalByRefObject.

-ou-

O assembly que contém type é um assembly dinâmico que foi criado com Save.

-ou-

O construtor que melhor corresponde args tem argumentos varargs.

O construtor chamado gera uma exceção.

O chamador não tem permissão para chamar esse construtor.

Não é possível criar uma instância de uma classe abstrata ou esse membro foi invocado com um mecanismo de associação tardia.

O tipo COM não foi obtido por meio de GetTypeFromProgID ou GetTypeFromCLSID.

Nenhum construtor correspondente foi encontrado.

type é um objeto COM, mas o identificador de classe usado para obter o tipo é inválido ou a classe identificada não está registrada.

type não é um tipo válido.

Comentários

O construtor a ser invocado deve fornecer a correspondência mais específica com a lista de argumentos especificada sob as restrições do associador especificado e dos atributos de associação.

Observação

A partir do .NET Framework 2.0, esse método poderá ser usado para acessar tipos e membros não públicos se o chamador tiver recebido ReflectionPermission com o sinalizador ReflectionPermissionFlag.RestrictedMemberAccess e se o conjunto de concessão dos tipos e membros não públicos estiver restrito ao conjunto de concessões do chamador ou a um subconjunto dele. (Consulte considerações de segurança para reflexão.) Para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3.5 ou posterior.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo)

Origem:
Activator.cs
Origem:
Activator.cs
Origem:
Activator.cs

Cria uma instância do tipo especificado usando o construtor que melhor corresponde aos parâmetros especificados.

public static object? CreateInstance (Type type, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture);
public static object CreateInstance (Type type, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture);

Parâmetros

type
Type

O tipo de objeto a ser criado.

bindingAttr
BindingFlags

Uma combinação de sinalizadores de zero ou mais bits que afetam a pesquisa do construtor type. Se bindingAttr for zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos será realizada.

binder
Binder

Um objeto que usa bindingAttr e args para procurar e identificar o construtor type. Se binder for null, o associador padrão será usado.

args
Object[]

Uma matriz de argumentos que correspondem em número, ordem e digite os parâmetros do construtor a ser invocado. Se args for uma matriz vazia ou null, o construtor que não usa parâmetros (o construtor sem parâmetros) será invocado.

culture
CultureInfo

Informações específicas da cultura que regem a coerção de args aos tipos formais declarados para o construtor type. Se culture for null, o CultureInfo do thread atual será usado.

Retornos

Uma referência ao objeto recém-criado ou null para instâncias Nullable<T> sem valor.

Exceções

type é null.

type não é um RuntimeType.

-ou-

type é um tipo genérico aberto (ou seja, a propriedade ContainsGenericParameters retorna true).

type não pode ser um TypeBuilder.

-ou-

Não há suporte para a criação de tipos TypedReference, ArgIterator, Voide RuntimeArgumentHandle ou matrizes desses tipos.

-ou-

O assembly que contém type é um assembly dinâmico que foi criado com Save.

-ou-

O construtor que melhor corresponde args tem argumentos varargs.

O construtor chamado gera uma exceção.

O chamador não tem permissão para chamar esse construtor.

Não é possível criar uma instância de uma classe abstrata ou esse membro foi invocado com um mecanismo de associação tardia.

O tipo COM não foi obtido por meio de GetTypeFromProgID ou GetTypeFromCLSID.

Nenhum construtor correspondente foi encontrado.

type é um objeto COM, mas o identificador de classe usado para obter o tipo é inválido ou a classe identificada não está registrada.

type não é um tipo válido.

Comentários

O construtor a ser invocado deve fornecer a correspondência mais específica com a lista de argumentos especificada sob as restrições do associador especificado e dos atributos de associação.

Observação

A partir do .NET Framework 2.0, esse método poderá ser usado para acessar tipos e membros não públicos se o chamador tiver recebido ReflectionPermission com o sinalizador ReflectionPermissionFlag.RestrictedMemberAccess e se o conjunto de concessões do assembly que contém os tipos não públicos e os membros estiver restrito ao conjunto de concessões do chamador ou a um subconjunto dele. (Consulte considerações de segurança para reflexão.) Para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3.5 ou posterior.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

CreateInstance(Type, Object[], Object[])

Origem:
Activator.cs
Origem:
Activator.cs
Origem:
Activator.cs

Cria uma instância do tipo especificado usando o construtor que melhor corresponde aos parâmetros especificados.

public static object? CreateInstance (Type type, object?[]? args, object?[]? activationAttributes);
public static object CreateInstance (Type type, object[] args, object[] activationAttributes);

Parâmetros

type
Type

O tipo de objeto a ser criado.

args
Object[]

Uma matriz de argumentos que correspondem em número, ordem e digite os parâmetros do construtor a ser invocado. Se args for uma matriz vazia ou null, o construtor que não usa parâmetros (o construtor sem parâmetros) será invocado.

activationAttributes
Object[]

Uma matriz de um ou mais atributos que podem participar da ativação. Normalmente, essa é uma matriz que contém um único objeto UrlAttribute que especifica a URL necessária para ativar um objeto remoto.

Esse parâmetro está relacionado a objetos ativados pelo cliente. A ativação do cliente é uma tecnologia herdada que é retida para compatibilidade com versões anteriores, mas não é recomendada para o novo desenvolvimento. Em vez disso, os aplicativos distribuídos devem usar o Windows Communication Foundation.

Retornos

Uma referência ao objeto recém-criado ou null para instâncias Nullable<T> sem valor.

Exceções

type é null.

type não é um RuntimeType.

-ou-

type é um tipo genérico aberto (ou seja, a propriedade ContainsGenericParameters retorna true).

type não pode ser um TypeBuilder.

-ou-

Não há suporte para a criação de tipos TypedReference, ArgIterator, Voide RuntimeArgumentHandle ou matrizes desses tipos.

-ou-

activationAttributes não é uma matriz vazia e o tipo que está sendo criado não deriva de MarshalByRefObject.

-ou-

O assembly que contém type é um assembly dinâmico que foi criado com Save.

-ou-

O construtor que melhor corresponde args tem argumentos varargs.

O construtor chamado gera uma exceção.

O chamador não tem permissão para chamar esse construtor.

Não é possível criar uma instância de uma classe abstrata ou esse membro foi invocado com um mecanismo de associação tardia.

O tipo COM não foi obtido por meio de GetTypeFromProgID ou GetTypeFromCLSID.

Nenhum construtor público correspondente foi encontrado.

type é um objeto COM, mas o identificador de classe usado para obter o tipo é inválido ou a classe identificada não está registrada.

type não é um tipo válido.

Comentários

O construtor a ser invocado deve ser acessível e deve fornecer a correspondência mais específica com a lista de argumentos especificada.

Observação

A partir do .NET Framework 2.0, esse método poderá ser usado para acessar tipos não públicos se o chamador tiver recebido ReflectionPermission com o sinalizador ReflectionPermissionFlag.RestrictedMemberAccess e se o conjunto de concessões do assembly que contém os tipos não públicos estiver restrito ao conjunto de concessões do chamador ou a um subconjunto dele. (Consulte considerações de segurança para reflexão.) Para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3.5 ou posterior.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

CreateInstance(String, String, Object[])

Origem:
Activator.RuntimeType.cs
Origem:
Activator.RuntimeType.cs
Origem:
Activator.RuntimeType.cs

Cria uma instância do tipo cujo nome é especificado, usando o assembly nomeado e o construtor sem parâmetros.

public static System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName, object?[]? activationAttributes);
public static System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName, object[] activationAttributes);

Parâmetros

assemblyName
String

O nome do assembly em que o tipo chamado typeName é procurado. Se assemblyName for null, o assembly em execução será pesquisado.

typeName
String

O nome totalmente qualificado do tipo do qual criar uma instância.

activationAttributes
Object[]

Uma matriz de um ou mais atributos que podem participar da ativação. Normalmente, essa é uma matriz que contém um único objeto UrlAttribute que especifica a URL necessária para ativar um objeto remoto.

Esse parâmetro está relacionado a objetos ativados pelo cliente. A ativação do cliente é uma tecnologia herdada que é retida para compatibilidade com versões anteriores, mas não é recomendada para o novo desenvolvimento. Em vez disso, os aplicativos distribuídos devem usar o Windows Communication Foundation.

Retornos

Um identificador que deve ser desembrulhado para acessar o objeto recém-criado ou null para instâncias de Nullable<T>.

Exceções

typeName é null.

Nenhum construtor público correspondente foi encontrado.

typeName não foi encontrado em assemblyName.

assemblyName não foi encontrado.

O chamador não tem permissão para chamar esse construtor.

Não é possível criar uma instância de uma classe abstrata ou esse membro foi invocado com um mecanismo de associação tardia.

O tipo COM não foi obtido por meio de GetTypeFromProgID ou GetTypeFromCLSID.

Não há suporte para a criação de tipos TypedReference, ArgIterator, Voide RuntimeArgumentHandle ou matrizes desses tipos.

-ou-

activationAttributes não é uma matriz vazia e o tipo que está sendo criado não deriva de MarshalByRefObject.

-ou-

activationAttributes não é um UrlAttribute

array.

assemblyName não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyName foi compilado para uma versão do CLR posterior à versão carregada no momento. Observe que as versões do .NET Framework 2.0, 3.0 e 3.5 usam clr versão 2.0.

Um assembly ou módulo foi carregado duas vezes com duas evidências diferentes.

-ou-

O nome do assembly ou base de código é inválido.

O construtor invocado gera uma exceção.

-ou-

Erro ao tentar ativação remota em um destino especificado em activationAttributes.

Comentários

Use ObjectHandle.Unwrap para desembrulhar o valor retornado.

Observação

A partir do .NET Framework 2.0, esse método poderá ser usado para criar tipos não públicos se o chamador tiver recebido ReflectionPermission com o sinalizador ReflectionPermissionFlag.RestrictedMemberAccess e se o conjunto de concessões dos tipos não públicos estiver restrito ao conjunto de concessões do chamador ou a um subconjunto dele. (Consulte considerações de segurança para reflexão.) Para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3.5 ou posterior.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

Cuidado

Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstance which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.

Cria uma instância do tipo cujo nome é especificado, usando o assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

public static System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes, System.Security.Policy.Evidence securityInfo);
[System.Obsolete("Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstance which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes, System.Security.Policy.Evidence securityInfo);

Parâmetros

assemblyName
String

O nome do assembly em que o tipo chamado typeName é procurado. Se assemblyName for null, o assembly em execução será pesquisado.

typeName
String

O nome totalmente qualificado do tipo do qual criar uma instância.

ignoreCase
Boolean

true especificar que a pesquisa por typeName não diferencia maiúsculas de minúsculas; false especificar que a pesquisa diferencia maiúsculas de minúsculas.

bindingAttr
BindingFlags

Uma combinação de sinalizadores de zero ou mais bits que afetam a pesquisa do construtor typeName. Se bindingAttr for zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos será realizada.

binder
Binder

Um objeto que usa bindingAttr e args para procurar e identificar o construtor typeName. Se binder for null, o associador padrão será usado.

args
Object[]

Uma matriz de argumentos que correspondem em número, ordem e digite os parâmetros do construtor a ser invocado. Se args for uma matriz vazia ou null, o construtor que não usa parâmetros (o construtor sem parâmetros) será invocado.

culture
CultureInfo

Informações específicas da cultura que regem a coerção de args aos tipos formais declarados para o construtor typeName. Se culture for null, o CultureInfo do thread atual será usado.

activationAttributes
Object[]

Uma matriz de um ou mais atributos que podem participar da ativação. Normalmente, essa é uma matriz que contém um único objeto UrlAttribute que especifica a URL necessária para ativar um objeto remoto.

Esse parâmetro está relacionado a objetos ativados pelo cliente. A ativação do cliente é uma tecnologia herdada que é retida para compatibilidade com versões anteriores, mas não é recomendada para o novo desenvolvimento. Em vez disso, os aplicativos distribuídos devem usar o Windows Communication Foundation.

securityInfo
Evidence

Informações usadas para tomar decisões de política de segurança e conceder permissões de código.

Retornos

Um identificador que deve ser desembrulhado para acessar o objeto recém-criado ou null para instâncias Nullable<T> sem valor.

Atributos

Exceções

typeName é null.

Nenhum construtor correspondente foi encontrado.

typeName não foi encontrado em assemblyName.

assemblyName não foi encontrado.

O chamador não tem permissão para chamar esse construtor.

Não é possível criar uma instância de uma classe abstrata ou esse membro foi invocado com um mecanismo de associação tardia.

O construtor, que foi invocado por meio da reflexão, lançou uma exceção.

O tipo COM não foi obtido por meio de GetTypeFromProgID ou GetTypeFromCLSID.

Não há suporte para a criação de tipos TypedReference, ArgIterator, Voide RuntimeArgumentHandle ou matrizes desses tipos.

-ou-

activationAttributes não é uma matriz vazia e o tipo que está sendo criado não deriva de MarshalByRefObject.

-ou-

O construtor que melhor corresponde args tem argumentos varargs.

assemblyName não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyName foi compilado para uma versão do CLR posterior à versão carregada no momento. Observe que as versões do .NET Framework 2.0, 3.0 e 3.5 usam clr versão 2.0.

Um assembly ou módulo foi carregado duas vezes com duas evidências diferentes.

-ou-

O nome do assembly ou base de código é inválido.

Comentários

Use ObjectHandle.Unwrap para desembrulhar o valor retornado.

Observação

A partir do .NET Framework 2.0, esse método poderá ser usado para criar tipos e membros não públicos se o chamador tiver recebido ReflectionPermission com o sinalizador ReflectionPermissionFlag.RestrictedMemberAccess e se o conjunto de concessões do assembly que contém os tipos e membros não públicos estiver restrito ao conjunto de concessões do chamador ou a um subconjunto dele. (Consulte considerações de segurança para reflexão.) Para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3.5 ou posterior.

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões (Obsoleto)
.NET Framework 1.1, 2.0, 3.0, 3.5 (4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1)

CreateInstance(Type, Object[])

Origem:
Activator.cs
Origem:
Activator.cs
Origem:
Activator.cs

Cria uma instância do tipo especificado usando o construtor que melhor corresponde aos parâmetros especificados.

public static object CreateInstance (Type type, params object[] args);
public static object? CreateInstance (Type type, params object?[]? args);
public static object CreateInstance (Type type, object[] args);

Parâmetros

type
Type

O tipo de objeto a ser criado.

args
Object[]

Uma matriz de argumentos que correspondem em número, ordem e digite os parâmetros do construtor a ser invocado. Se args for uma matriz vazia ou null, o construtor que não usa parâmetros (o construtor sem parâmetros) será invocado.

Retornos

Uma referência ao objeto recém-criado ou null para instâncias Nullable<T> sem valor.

Exceções

type é null.

type não é um RuntimeType.

-ou-

type é um tipo genérico aberto (ou seja, a propriedade ContainsGenericParameters retorna true).

type não pode ser um TypeBuilder.

-ou-

Não há suporte para a criação de tipos TypedReference, ArgIterator, Voide RuntimeArgumentHandle ou matrizes desses tipos.

-ou-

O assembly que contém type é um assembly dinâmico que foi criado com Save.

-ou-

O construtor que melhor corresponde args tem argumentos varargs.

O construtor chamado gera uma exceção.

O chamador não tem permissão para chamar esse construtor.

Observação: em .NET para aplicativos da Windows Store ou na biblioteca de classes portátil , pegue a exceção de classe base, MemberAccessException, em vez disso.

Não é possível criar uma instância de uma classe abstrata ou esse membro foi invocado com um mecanismo de associação tardia.

O tipo COM não foi obtido por meio de GetTypeFromProgID ou GetTypeFromCLSID.

Nenhum construtor público correspondente foi encontrado.

Observação: em .NET para aplicativos da Windows Store ou na biblioteca de classes portátil , pegue a exceção de classe base, MissingMemberException, em vez disso.

type é um objeto COM, mas o identificador de classe usado para obter o tipo é inválido ou a classe identificada não está registrada.

type não é um tipo válido.

Exemplos

O exemplo a seguir chama o método CreateInstance(Type, Object[]) para criar um objeto String. Ele chama o construtor String.String(Char[], Int32, Int32) para criar uma instância de uma cadeia de caracteres que contém dez elementos de uma matriz de caracteres começando na décima quarta posição.

using System;

public class Example
{
   public static void Main()
   {
      // Initialize array of characters from a to z.
      char[] chars = new char[26];
      for (int ctr = 0; ctr < 26; ctr++)
         chars[ctr] = (char) (ctr + 0x0061);

      object obj = Activator.CreateInstance(typeof(string),
                                            new object[] { chars, 13, 10 } );
      Console.WriteLine(obj);
   }
}
// The example displays the following output:
//       nopqrstuvw

O exemplo a seguir cria uma matriz irregular cujos elementos são argumentos a serem passados para um construtor String. Em seguida, o exemplo passa cada matriz para o método CreateInstance(Type, Object[]) para invocar o construtor de cadeia de caracteres apropriado.

using System;

public class Example
{
   public static void Main()
   {
      char[] characters = { 'a', 'b', 'c', 'd', 'e', 'f' };
      object[][] arguments = new object[3][] { new object[] { characters },
                                               new object[] { characters, 1, 4 },
                                               new object[] { characters[1], 20 } };

      for (int ctr = 0; ctr <= arguments.GetUpperBound(0); ctr++) {
         object[] args = arguments[ctr];
         object result = Activator.CreateInstance(typeof(string), args);
         Console.WriteLine("{0}: {1}", result.GetType().Name, result);
      }
   }
}
// The example displays the following output:
//    String: abcdef
//    String: bcde
//    String: bbbbbbbbbbbbbbbbbbbb

Comentários

O construtor a ser invocado deve ser acessível e deve fornecer a correspondência mais específica com a lista de argumentos especificada.

Observação

A partir do .NET Framework 2.0, esse método poderá ser usado para acessar tipos não públicos se o chamador tiver recebido ReflectionPermission com o sinalizador ReflectionPermissionFlag.RestrictedMemberAccess e se o conjunto de concessões do assembly que contém os tipos não públicos estiver restrito ao conjunto de concessões do chamador ou a um subconjunto dele. (Consulte considerações de segurança para reflexão.) Para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3.5 ou posterior.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

CreateInstance(Type, Boolean)

Origem:
Activator.RuntimeType.cs
Origem:
Activator.RuntimeType.cs
Origem:
Activator.RuntimeType.cs

Cria uma instância do tipo especificado usando o construtor sem parâmetros desse tipo.

public static object? CreateInstance (Type type, bool nonPublic);
public static object CreateInstance (Type type, bool nonPublic);

Parâmetros

type
Type

O tipo de objeto a ser criado.

nonPublic
Boolean

true se um construtor público ou não público sem parâmetros puder corresponder; false se apenas um construtor público sem parâmetros puder corresponder.

Retornos

Uma referência ao objeto recém-criado ou null para instâncias de Nullable<T>.

Exceções

type é null.

type não é um RuntimeType.

-ou-

type é um tipo genérico aberto (ou seja, a propriedade ContainsGenericParameters retorna true).

type não pode ser um TypeBuilder.

-ou-

Não há suporte para a criação de tipos TypedReference, ArgIterator, Voide RuntimeArgumentHandle ou matrizes desses tipos.

-ou-

O assembly que contém type é um assembly dinâmico que foi criado com Save.

O construtor chamado gera uma exceção.

O chamador não tem permissão para chamar esse construtor.

Não é possível criar uma instância de uma classe abstrata ou esse membro foi invocado com um mecanismo de associação tardia.

O tipo COM não foi obtido por meio de GetTypeFromProgID ou GetTypeFromCLSID.

Nenhum construtor público correspondente foi encontrado.

type é um objeto COM, mas o identificador de classe usado para obter o tipo é inválido ou a classe identificada não está registrada.

type não é um tipo válido.

Comentários

Observação

A partir do .NET Framework 2.0, esse método poderá ser usado para acessar tipos e membros não públicos se o chamador tiver recebido ReflectionPermission com o sinalizador ReflectionPermissionFlag.RestrictedMemberAccess e se o conjunto de concessões do assembly que contém os tipos não públicos e os membros estiver restrito ao conjunto de concessões do chamador ou a um subconjunto dele. (Consulte considerações de segurança para reflexão.) Para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3.5 ou posterior.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.5, 1.6, 2.0, 2.1

CreateInstance(String, String)

Origem:
Activator.RuntimeType.cs
Origem:
Activator.RuntimeType.cs
Origem:
Activator.RuntimeType.cs

Cria uma instância do tipo cujo nome é especificado, usando o assembly nomeado e o construtor sem parâmetros.

public static System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName);
public static System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName);

Parâmetros

assemblyName
String

O nome do assembly em que o tipo chamado typeName é procurado. Se assemblyName for null, o assembly em execução será pesquisado.

typeName
String

O nome totalmente qualificado do tipo do qual criar uma instância.

Retornos

Um identificador que deve ser desembrulhado para acessar o objeto recém-criado ou null para instâncias de Nullable<T>.

Exceções

typeName é null.

Nenhum construtor público correspondente foi encontrado.

typeName não foi encontrado em assemblyName.

assemblyName não foi encontrado.

O chamador não tem permissão para chamar esse construtor.

Você não pode criar uma instância de uma classe abstrata ou esse membro foi invocado com um mecanismo de associação tardia.

O construtor, que foi invocado por meio da reflexão, lançou uma exceção.

O tipo COM não foi obtido por meio de GetTypeFromProgID ou GetTypeFromCLSID.

Não há suporte para a criação de tipos TypedReference, ArgIterator, Voide RuntimeArgumentHandle ou matrizes desses tipos.

assemblyName não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyName foi compilado para uma versão do CLR posterior à versão carregada no momento. Observe que as versões do .NET Framework 2.0, 3.0 e 3.5 usam clr versão 2.0.

Um assembly ou módulo foi carregado duas vezes com duas evidências diferentes.

-ou-

O nome do assembly ou base de código é inválido.

Exemplos

O exemplo a seguir define uma classe chamada Person em um assembly chamado PersonInfo. Observe que a classe Person tem dois construtores, um deles sem parâmetros.

using System;

public class Person
{
   private string _name;

   public Person()
   { }

   public Person(string name)
   {
      this._name = name;
   }

   public string Name
   { get { return this._name; }
     set { this._name = value; } }

   public override string ToString()
   {
      return this._name;
   }
}

O exemplo a seguir chama o método CreateInstance(String, String) para instanciar a classe Person. Ele requer uma referência a PersonInfo.dll a serem adicionados ao projeto. Como o método CreateInstance(String, String) chama o construtor sem parâmetros da classe Person, o exemplo atribui um valor à propriedade Name.

using System;
using System.Runtime.Remoting;

public class Example
{
   public static void Main()
   {
      ObjectHandle handle = Activator.CreateInstance("PersonInfo", "Person");
      Person p = (Person) handle.Unwrap();
      p.Name = "Samuel";
      Console.WriteLine(p);
   }
}
// The example displays the following output:
//        Samuel

No entanto, CreateInstance é frequentemente chamado para criar uma instância de um tipo que ultrapassa os limites da máquina ou que não é conhecido em tempo de design. Nesse caso, você não pode incluir uma referência ao assembly no projeto e não pode fazer chamadas com limite antecipado para os membros do tipo. Para contornar essa limitação, o exemplo a seguir usa o método CreateInstance juntamente com a reflexão para atribuir um valor à propriedade Name do objeto Person e exibir seu valor.

using System;
using System.Reflection;
using System.Runtime.Remoting;

public class Example
{
   public static void Main()
   {
      ObjectHandle handle = Activator.CreateInstance("PersonInfo", "Person");
      object p = handle.Unwrap();
      Type t = p.GetType();
      PropertyInfo prop = t.GetProperty("Name");
      if (prop != null)
         prop.SetValue(p, "Samuel");

      MethodInfo method = t.GetMethod("ToString");
      object retVal = method.Invoke(p, null);
      if (retVal != null)
         Console.WriteLine(retVal);
   }
}
// The example displays the following output:
//        Samuel

Comentários

Use ObjectHandle.Unwrap para desembrulhar o valor retornado.

assemblyName pode ser um dos seguintes:

  • O nome simples de um assembly, sem seu caminho ou extensão de arquivo. Por exemplo, você especificaria TypeExtensions para um assembly cujo caminho e nome são .\bin\TypeExtensions.dll.

  • O nome completo de um assembly assinado, que consiste em seu nome simples, versão, cultura e token de chave pública; por exemplo, "TypeExtensions, Version=1.0.0.0, Culture=neutral, PublicKeyToken=181869f2f7435b51".

Para obter mais informações sobre como o common language runtime identifica e carrega assemblies, consulte How the Runtime Locates Assemblies. Para obter informações sobre como usar o arquivo de configuração do aplicativo para definir locais de assembly, consulte Especificando o local de um assembly. Se assemblyName for encontrado, ele será carregado no contexto padrão.

Observação

A partir do .NET Framework 2.0, esse método poderá ser usado para criar tipos não públicos se o chamador tiver recebido ReflectionPermission com o sinalizador ReflectionPermissionFlag.RestrictedMemberAccess e se o conjunto de concessões do assembly que contém os tipos não públicos estiver restrito ao conjunto de concessões do chamador ou a um subconjunto dele. (Consulte considerações de segurança para reflexão.) Para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3.5 ou posterior.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

CreateInstance(ActivationContext, String[])

Cria uma instância do tipo que é designada pelo objeto ActivationContext especificado e ativada com os dados de ativação personalizados especificados.

public static System.Runtime.Remoting.ObjectHandle CreateInstance (ActivationContext activationContext, string[] activationCustomData);

Parâmetros

activationContext
ActivationContext

Um objeto de contexto de ativação que especifica o objeto a ser criado.

activationCustomData
String[]

Uma matriz de cadeias de caracteres Unicode que contêm dados de ativação personalizados.

Retornos

Um identificador que deve ser desembrulhado para acessar o objeto recém-criado ou null para instâncias de Nullable<T>.

Comentários

Use o método ObjectHandle.Unwrap para desembrulhar o valor retornado.

O contexto de ativação é usado durante a ativação baseada em manifesto para configurar a política de domínio e fornecer um modelo de segurança baseado em aplicativo. A classe ActivationContext contém um objeto ApplicationIdentity que fornece acesso ao manifesto do aplicativo. Para obter mais informações, consulte a classe ApplicationSecurityManager.

Confira também

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

CreateInstance(Type)

Origem:
Activator.cs
Origem:
Activator.cs
Origem:
Activator.cs

Cria uma instância do tipo especificado usando o construtor sem parâmetros desse tipo.

public static object CreateInstance (Type type);
public static object? CreateInstance (Type type);

Parâmetros

type
Type

O tipo de objeto a ser criado.

Retornos

Uma referência ao objeto recém-criado ou null para instâncias de Nullable<T>.

Exceções

type é null.

type não é um RuntimeType.

-ou-

type é um tipo genérico aberto (ou seja, a propriedade ContainsGenericParameters retorna true).

type não pode ser um TypeBuilder.

-ou-

Não há suporte para a criação de tipos TypedReference, ArgIterator, Voide RuntimeArgumentHandle ou matrizes desses tipos.

-ou-

O assembly que contém type é um assembly dinâmico que foi criado com Save.

O construtor chamado gera uma exceção.

O chamador não tem permissão para chamar esse construtor.

Observação: em .NET para aplicativos da Windows Store ou na biblioteca de classes portátil , pegue a exceção de classe base, MemberAccessException, em vez disso.

Não é possível criar uma instância de uma classe abstrata ou esse membro foi invocado com um mecanismo de associação tardia.

O tipo COM não foi obtido por meio de GetTypeFromProgID ou GetTypeFromCLSID.

Nenhum construtor público correspondente foi encontrado.

Observação: em .NET para aplicativos da Windows Store ou na biblioteca de classes portátil , pegue a exceção de classe base, MissingMemberException, em vez disso.

type é um objeto COM, mas o identificador de classe usado para obter o tipo é inválido ou a classe identificada não está registrada.

type não é um tipo válido.

Exemplos

O exemplo de código a seguir demonstra como chamar o método CreateInstance(Type). Instâncias de vários tipos diferentes são criadas e seus valores padrão são exibidos.

using System;

class DynamicInstanceList
{
    private static string instanceSpec = "System.EventArgs;System.Random;" +
        "System.Exception;System.Object;System.Version";

    public static void Main()
    {
        string[] instances = instanceSpec.Split(';');
        Array instlist = Array.CreateInstance(typeof(object), instances.Length);
        object item;
        for (int i = 0; i < instances.Length; i++)
        {
            // create the object from the specification string
            Console.WriteLine("Creating instance of: {0}", instances[i]);
            item = Activator.CreateInstance(Type.GetType(instances[i]));
            instlist.SetValue(item, i);
        }
        Console.WriteLine("\nObjects and their default values:\n");
        foreach (object o in instlist)
        {
            Console.WriteLine("Type:     {0}\nValue:    {1}\nHashCode: {2}\n",
                o.GetType().FullName, o.ToString(), o.GetHashCode());
        }
    }
}

// This program will display output similar to the following:
//
// Creating instance of: System.EventArgs
// Creating instance of: System.Random
// Creating instance of: System.Exception
// Creating instance of: System.Object
// Creating instance of: System.Version
//
// Objects and their default values:
//
// Type:     System.EventArgs
// Value:    System.EventArgs
// HashCode: 46104728
//
// Type:     System.Random
// Value:    System.Random
// HashCode: 12289376
//
// Type:     System.Exception
// Value:    System.Exception: Exception of type 'System.Exception' was thrown.
// HashCode: 55530882
//
// Type:     System.Object
// Value:    System.Object
// HashCode: 30015890
//
// Type:     System.Version
// Value:    0.0
// HashCode: 1048575

Comentários

O construtor a ser invocado deve estar acessível.

Observação

A partir do .NET Framework 2.0, esse método poderá ser usado para acessar tipos não públicos se o chamador tiver recebido ReflectionPermission com o sinalizador ReflectionPermissionFlag.RestrictedMemberAccess e se o conjunto de concessões do assembly que contém os tipos não públicos estiver restrito ao conjunto de concessões do chamador ou a um subconjunto dele. (Consulte considerações de segurança para reflexão.) Para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3.5 ou posterior.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

CreateInstance(ActivationContext)

Cria uma instância do tipo designado pelo objeto ActivationContext especificado.

public static System.Runtime.Remoting.ObjectHandle CreateInstance (ActivationContext activationContext);

Parâmetros

activationContext
ActivationContext

Um objeto de contexto de ativação que especifica o objeto a ser criado.

Retornos

Um identificador que deve ser desembrulhado para acessar o objeto recém-criado ou null para instâncias de Nullable<T>.

Comentários

Use o método ObjectHandle.Unwrap para desembrulhar o valor retornado.

O contexto de ativação é usado durante a ativação baseada em manifesto para configurar a política de domínio e fornecer um modelo de segurança baseado em aplicativo. A classe ActivationContext contém um objeto ApplicationIdentity que fornece acesso ao manifesto do aplicativo. Para obter mais informações, consulte a classe ApplicationSecurityManager.

Confira também

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

CreateInstance(AppDomain, String, String)

Cria uma instância do tipo cujo nome é especificado no domínio remoto especificado, usando o assembly nomeado e o construtor sem parâmetros.

public static System.Runtime.Remoting.ObjectHandle CreateInstance (AppDomain domain, string assemblyName, string typeName);
[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstance (AppDomain domain, string assemblyName, string typeName);

Parâmetros

domain
AppDomain

O domínio remoto em que o tipo chamado typeName é criado.

assemblyName
String

O nome do assembly em que o tipo chamado typeName é procurado. Se assemblyName for null, o assembly em execução será pesquisado.

typeName
String

O nome totalmente qualificado do tipo do qual criar uma instância.

Retornos

Um identificador que deve ser desembrulhado para acessar o objeto recém-criado ou null para instâncias de Nullable<T>.

Atributos

Exceções

typeName ou domain é null.

Nenhum construtor público correspondente foi encontrado.

typeName não foi encontrado em assemblyName.

assemblyName não foi encontrado.

O chamador não tem permissão para chamar esse construtor.

Não é possível criar uma instância de um tipo abstrato.

-ou-

Esse membro foi invocado com um mecanismo de associação tardia.

O construtor, que foi invocado por meio da reflexão, lançou uma exceção.

O tipo COM não foi obtido por meio de GetTypeFromProgID ou GetTypeFromCLSID.

Não há suporte para a criação de tipos TypedReference, ArgIterator, Voide RuntimeArgumentHandle ou matrizes desses tipos.

assemblyName não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyName foi compilado para uma versão do CLR posterior à versão carregada no momento. Observe que as versões do .NET Framework 2.0, 3.0 e 3.5 usam clr versão 2.0.

Um assembly ou módulo foi carregado duas vezes com duas evidências diferentes.

-ou-

O nome do assembly ou base de código é inválido.

Comentários

Use CreateInstance quando um host precisar executar código em um domínio de aplicativo que tenha permissões de segurança restritas.

Use ObjectHandle.Unwrap para desembrulhar o valor retornado.

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

CreateInstance<T>()

Origem:
Activator.RuntimeType.cs
Origem:
Activator.RuntimeType.cs
Origem:
Activator.RuntimeType.cs

Cria uma instância do tipo designado pelo parâmetro de tipo genérico especificado, usando o construtor sem parâmetros.

public static T CreateInstance<T> ();

Parâmetros de tipo

T

O tipo a ser criado.

Retornos

T

Uma referência ao objeto recém-criado ou null para instâncias de Nullable<T>.

Exceções

Não é possível criar uma instância de uma classe abstrata ou o tipo especificado para T não tem um construtor sem parâmetros.

Observação: em .NET para aplicativos da Windows Store ou na biblioteca de classes portátil , pegue a exceção de classe base, MissingMemberException, em vez disso.

Comentários

O método CreateInstance<T>() genérico é usado por compiladores para implementar a instanciação de tipos especificados por parâmetros de tipo. Por exemplo, no método genérico a seguir, a implementação de new T() (gcnew T() no C++) usa o método genérico CreateInstance<T>().

public static T Factory<T>() where T : new()
{
    return new T();
}

Em geral, não há uso para o método genérico CreateInstance<T>() no código do aplicativo, pois o tipo deve ser conhecido no momento da compilação. Se o tipo for conhecido no tempo de compilação, a sintaxe de instanciação normal poderá ser usada ( operadornew em C#, New no Visual Basic, gcnew em C++). Se o tipo não for conhecido no momento da compilação, você poderá chamar uma sobrecarga não genérica de CreateInstance.

Não há sobrecargas do método genérico CreateInstance<T>() que usa listas de argumentos, pois as sobrecargas não genéricas de CreateInstance já fornecem resolução de construtor com limite tardio.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0