AppDomain.CreateInstanceFromAndUnwrap Método

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria uma nova instância de um tipo especificado definido no arquivo de assembly especificado.

Sobrecargas

CreateInstanceFromAndUnwrap(String, String)	Cria uma nova instância do tipo especificado definido no arquivo de assembly especificado.
CreateInstanceFromAndUnwrap(String, String, Object[])	Cria uma nova instância do tipo especificado definido no arquivo de assembly especificado.
CreateInstanceFromAndUnwrap(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Cria uma nova instância do tipo especificado definido no arquivo de assembly especificado, especificando se o caso do nome do tipo é ignorado; os atributos de associação e o associador que são usados para selecionar o tipo a ser criado; os argumentos do construtor; a cultura; e os atributos de ativação.
CreateInstanceFromAndUnwrap(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)	Obsoleto. Cria uma nova instância do tipo especificado definido no arquivo de assembly especificado.

CreateInstanceFromAndUnwrap(String, String)

Origem:: AppDomain.cs

Origem:: AppDomain.cs

Origem:: AppDomain.cs

Cria uma nova instância do tipo especificado definido no arquivo de assembly especificado.

public:
 System::Object ^ CreateInstanceFromAndUnwrap(System::String ^ assemblyFile, System::String ^ typeName);

public:
 System::Object ^ CreateInstanceFromAndUnwrap(System::String ^ assemblyName, System::String ^ typeName);

public object? CreateInstanceFromAndUnwrap (string assemblyFile, string typeName);

public object CreateInstanceFromAndUnwrap (string assemblyName, string typeName);

member this.CreateInstanceFromAndUnwrap : string * string -> obj

member this.CreateInstanceFromAndUnwrap : string * string -> obj

Public Function CreateInstanceFromAndUnwrap (assemblyFile As String, typeName As String) As Object

Public Function CreateInstanceFromAndUnwrap (assemblyName As String, typeName As String) As Object

Parâmetros

assemblyFileassemblyName: String

typeName: String

O nome totalmente qualificado do tipo solicitado, incluindo o namespace, mas não o assembly, conforme retornado pela propriedade FullName.

Retornos

Object

O objeto solicitado ou null se typeName não for encontrado.

Exceções

ArgumentNullException

assemblyName é null.

-ou-

typeName é null.

AppDomainUnloadedException

A operação é tentada em um domínio de aplicativo descarregado.

FileNotFoundException

assemblyName não foi encontrado.

TypeLoadException

typeName não foi encontrado em assemblyName.

MissingMethodException

Nenhum construtor público sem parâmetros foi encontrado.

MethodAccessException

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

BadImageFormatException

assemblyName não é um assembly válido para o runtime carregado no momento.

FileLoadException

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

Comentários

Este é um método de conveniência que combina CreateInstanceFrom e ObjectHandle.Unwrap. Esse método chama o construtor sem parâmetros para typeName.

Para obter mais informações, consulte o método Activator.CreateInstanceFrom.

Confira também

CreateInstanceFrom(String, String)

Aplica-se a

CreateInstanceFromAndUnwrap(String, String, Object[])

Origem:: AppDomain.cs

Origem:: AppDomain.cs

Origem:: AppDomain.cs

Cria uma nova instância do tipo especificado definido no arquivo de assembly especificado.

public:
 System::Object ^ CreateInstanceFromAndUnwrap(System::String ^ assemblyFile, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);

public:
 System::Object ^ CreateInstanceFromAndUnwrap(System::String ^ assemblyName, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);

public object? CreateInstanceFromAndUnwrap (string assemblyFile, string typeName, object?[]? activationAttributes);

public object CreateInstanceFromAndUnwrap (string assemblyName, string typeName, object[] activationAttributes);

member this.CreateInstanceFromAndUnwrap : string * string * obj[] -> obj

member this.CreateInstanceFromAndUnwrap : string * string * obj[] -> obj

Public Function CreateInstanceFromAndUnwrap (assemblyFile As String, typeName As String, activationAttributes As Object()) As Object

Public Function CreateInstanceFromAndUnwrap (assemblyName As String, typeName As String, activationAttributes As Object()) As Object

Parâmetros

assemblyFileassemblyName: String

typeName: String

O nome totalmente qualificado do tipo solicitado, incluindo o namespace, mas não o assembly (consulte a propriedade FullName).

activationAttributes: Object[]

Uma matriz de um ou mais atributos que podem participar da ativação. Normalmente, 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

Object

O objeto solicitado ou null se typeName não for encontrado.

Exceções

ArgumentNullException

assemblyName é null.

-ou-

typeName é null.

NotSupportedException

O chamador não pode fornecer atributos de ativação para um objeto que não herda de MarshalByRefObject.

AppDomainUnloadedException

A operação é tentada em um domínio de aplicativo descarregado.

FileNotFoundException

assemblyName não foi encontrado.

TypeLoadException

typeName não foi encontrado em assemblyName.

MissingMethodException

Nenhum construtor público sem parâmetros foi encontrado.

MethodAccessException

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

BadImageFormatException

assemblyName não é um assembly válido para o runtime carregado no momento.

FileLoadException

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

Comentários

Este é um método de conveniência que combina CreateInstanceFrom e ObjectHandle.Unwrap. Esse método chama o construtor sem parâmetros para typeName.

Para obter mais informações sobre esse método, consulte o método Activator.CreateInstanceFrom.

Confira também

CreateInstanceFrom(String, String)

Aplica-se a

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

Origem:: AppDomain.cs

Origem:: AppDomain.cs

Origem:: AppDomain.cs

Cria uma nova instância do tipo especificado definido no arquivo de assembly especificado, especificando se o caso do nome do tipo é ignorado; os atributos de associação e o associador que são usados para selecionar o tipo a ser criado; os argumentos do construtor; a cultura; e os atributos de ativação.

public:
 System::Object ^ CreateInstanceFromAndUnwrap(System::String ^ assemblyFile, System::String ^ typeName, bool ignoreCase, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture, cli::array <System::Object ^> ^ activationAttributes);

public object? CreateInstanceFromAndUnwrap (string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);

public object CreateInstanceFromAndUnwrap (string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);

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

Public Function CreateInstanceFromAndUnwrap (assemblyFile As String, typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object()) As Object

Parâmetros

assemblyFile: String

O nome do arquivo e o caminho do assembly que define o tipo solicitado.

typeName: String

O nome totalmente qualificado do tipo solicitado, incluindo o namespace, mas não o assembly, conforme retornado pela propriedade FullName.

ignoreCase: Boolean

Um valor booliano que especifica se uma pesquisa diferencia maiúsculas de minúsculas ou não.

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 permite a associação, a coerção de tipos de argumento, a invocação de membros e a recuperação de objetos MemberInfo por meio da reflexão. Se binder for nulo, o associador padrão será usado.

args: Object[]

Os argumentos a serem passados para o construtor. Essa matriz de argumentos deve corresponder em número, ordem e digitar os parâmetros do construtor a ser invocado. Se o construtor sem parâmetros for preferencial, args deverá ser uma matriz vazia ou nula.

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, uma matriz que contém um único objeto UrlAttribute que especifica a URL necessária para ativar um objeto remoto.

Retornos

Object

O objeto solicitado ou null se typeName não for encontrado.

Exceções

ArgumentNullException

assemblyFile é null.

-ou-

typeName é null.

NotSupportedException

O chamador não pode fornecer atributos de ativação para um objeto que não herda de MarshalByRefObject.

AppDomainUnloadedException

A operação é tentada em um domínio de aplicativo descarregado.

FileNotFoundException

assemblyFile não foi encontrado.

TypeLoadException

typeName não foi encontrado em assemblyFile.

MissingMethodException

Nenhum construtor público correspondente foi encontrado.

MethodAccessException

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

BadImageFormatException

assemblyFile não é um assembly válido.

-ou-

assemblyFile foi compilado com uma versão posterior do common language runtime que a versão está carregada no momento.

FileLoadException

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

Comentários

Este é um método de conveniência que combina CreateInstanceFrom e ObjectHandle.Unwrap.

Para obter mais informações sobre esse método, consulte o método Activator.CreateInstanceFrom.

Confira também

CreateInstanceFrom(String, String)

Aplica-se a

CreateInstanceFromAndUnwrap(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 CreateInstanceFromAndUnwrap which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.

Cria uma nova instância do tipo especificado definido no arquivo de assembly especificado.

public:
 System::Object ^ CreateInstanceFromAndUnwrap(System::String ^ assemblyName, System::String ^ typeName, bool ignoreCase, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture, cli::array <System::Object ^> ^ activationAttributes, System::Security::Policy::Evidence ^ securityAttributes);

public object CreateInstanceFromAndUnwrap (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 CreateInstanceFromAndUnwrap which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public object CreateInstanceFromAndUnwrap (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);

member this.CreateInstanceFromAndUnwrap : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> obj

[<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 CreateInstanceFromAndUnwrap which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
member this.CreateInstanceFromAndUnwrap : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> obj

Public Function CreateInstanceFromAndUnwrap (assemblyName As String, typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object(), securityAttributes As Evidence) As Object

Parâmetros

assemblyName: String

O nome do arquivo e o caminho do assembly que define o tipo solicitado.

typeName: String

O nome totalmente qualificado do tipo solicitado, incluindo o namespace, mas não o assembly, conforme retornado pela propriedade FullName.

ignoreCase: Boolean

Um valor booliano que especifica se uma pesquisa diferencia maiúsculas de minúsculas ou não.

bindingAttr: BindingFlags

binder: Binder

args: Object[]

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, uma matriz que contém um único objeto UrlAttribute que especifica a URL necessária para ativar um objeto remoto.