Ler em inglês

Partilhar via


Activator.CreateInstanceFrom Método

Definição

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

Sobrecargas

CreateInstanceFrom(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 arquivo de assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

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

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

CreateInstanceFrom(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 arquivo de assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

CreateInstanceFrom(String, String, Object[])

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

CreateInstanceFrom(AppDomain, String, String)

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

CreateInstanceFrom(String, String)

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

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

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

CreateInstanceFrom(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 CreateInstanceFrom 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 arquivo de assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (AppDomain domain, string assemblyFile, 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 CreateInstanceFrom 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 CreateInstanceFrom (AppDomain domain, string assemblyFile, 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 remoto em que o tipo chamado typeName é criado.

assemblyFile
String

O nome de um arquivo que contém um assembly em que o tipo chamado typeName é procurado.

typeName
String

O nome 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.

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 de Nullable<T>.

Atributos

Exceções

domain ou typeName é null.

Nenhum construtor correspondente foi encontrado.

typeName não foi encontrado em assemblyFile.

assemblyFile 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 chamador tem o FileIOPermissionnecessário.

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

assemblyFile não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyFile 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.

Comentários

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

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

Para obter informações sobre outras exceções que podem ser geradas por métodos invocados, consulte a seção Exceções dos métodos Assembly.LoadFrom e CreateInstance.

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)

CreateInstanceFrom(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 CreateInstanceFrom 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 arquivo de assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (string assemblyFile, 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 CreateInstanceFrom which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (string assemblyFile, 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

assemblyFile
String

O nome de um arquivo que contém um assembly em que o tipo chamado typeName é procurado.

typeName
String

O nome 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 de Nullable<T>.

Atributos

Exceções

typeName é null.

Nenhum construtor correspondente foi encontrado.

typeName não foi encontrado em assemblyFile.

assemblyFile 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 chamador não tem o FileIOPermissionnecessário.

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

assemblyFile não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyFile 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.

Comentários

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

Para obter informações sobre outras exceções que podem ser geradas por métodos invocados, consulte a seção Exceções dos métodos Assembly.LoadFrom e CreateInstance.

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)

CreateInstanceFrom(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 arquivo de assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (AppDomain domain, string assemblyFile, 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 remoto em que o tipo chamado typeName é criado.

assemblyFile
String

O nome de um arquivo que contém um assembly em que o tipo chamado typeName é procurado.

typeName
String

O nome 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 de Nullable<T>.

Atributos

Exceções

domain ou typeName é null.

Nenhum construtor correspondente foi encontrado.

typeName não foi encontrado em assemblyFile.

assemblyFile 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 chamador tem o FileIOPermissionnecessário.

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

assemblyFile não é um assembly válido.

-ou-

assemblyFile foi compilado para uma versão do common language runtime que é posterior à versão carregada no momento.

Comentários

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

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

Para obter informações sobre outras exceções que podem ser geradas por métodos invocados, consulte as seções Exceções dos métodos Assembly.LoadFrom e CreateInstance.

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

CreateInstanceFrom(String, String, Object[])

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

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

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

Parâmetros

assemblyFile
String

O nome de um arquivo que contém um assembly em que o tipo chamado typeName é procurado.

typeName
String

O nome 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 assemblyFile.

assemblyFile 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.

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

O chamador tem o FileIOPermissionnecessário.

assemblyFile não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyFile 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.

Comentários

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

Para obter informações sobre outras exceções que podem ser geradas por métodos invocados, consulte a seção Exceções dos métodos Assembly.LoadFrom e CreateInstance.

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

CreateInstanceFrom(AppDomain, String, String)

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

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

Parâmetros

domain
AppDomain

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

assemblyFile
String

O nome de um arquivo que contém um assembly em que o tipo chamado typeName é procurado.

typeName
String

O nome 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

domain ou typeName é null.

Nenhum construtor público correspondente foi encontrado.

typeName não foi encontrado em assemblyFile.

assemblyFile 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 chamador tem o FileIOPermissionnecessário.

assemblyFile não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyFile 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.

Comentários

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

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

Para obter informações sobre outras exceções que podem ser geradas por métodos invocados, consulte a seção Exceções dos métodos Assembly.LoadFrom e CreateInstance.

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

CreateInstanceFrom(String, String)

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

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

public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName);
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (string assemblyFile, string typeName);

Parâmetros

assemblyFile
String

O nome de um arquivo que contém um assembly em que o tipo chamado typeName é procurado.

typeName
String

O nome 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 assemblyFile.

assemblyFile 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 chamador tem o FileIOPermissionnecessário.

assemblyFile não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyFile 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.

Exemplos

O exemplo de código a seguir demonstra como chamar o método CreateInstanceFrom. Este exemplo de código faz parte de um exemplo maior fornecido para a classe Activator.

// Create an instance of the SomeType class that is defined in this
// assembly.
System.Runtime.Remoting.ObjectHandle oh =
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase,
                                 typeof(SomeType).FullName);

// Call an instance method defined by the SomeType type using this object.
SomeType st = (SomeType) oh.Unwrap();

st.DoSomething(5);

Comentários

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

Para obter informações sobre outras exceções que podem ser geradas por métodos invocados, consulte a seção Exceções dos métodos Assembly.LoadFrom e CreateInstance.

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

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

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

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

public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, 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 CreateInstanceFrom (string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);

Parâmetros

assemblyFile
String

O nome de um arquivo que contém um assembly em que o tipo chamado typeName é procurado.

typeName
String

O nome 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 de Nullable<T>.

Exceções

typeName é null.

Nenhum construtor correspondente foi encontrado.

typeName não foi encontrado em assemblyFile.

assemblyFile 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 chamador não tem o FileIOPermissionnecessário.

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

assemblyFile não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyFile 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.

Comentários

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

Para obter informações sobre outras exceções que podem ser geradas por métodos invocados, consulte a seção Exceções dos métodos Assembly.LoadFrom e CreateInstance.

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