AppDomain.CreateInstanceFromAndUnwrap Método

Definição

Cria uma nova instância de um tipo especificado definido no arquivo de assembly especificado.Creates a new instance of a specified type defined in the specified assembly file.

Sobrecargas

CreateInstanceFromAndUnwrap(String, String)

Cria uma nova instância do tipo especificado definido no arquivo de assembly especificado.Creates a new instance of the specified type defined in the specified assembly file.

CreateInstanceFromAndUnwrap(String, String, Object[])

Cria uma nova instância do tipo especificado definido no arquivo de assembly especificado.Creates a new instance of the specified type defined in the specified assembly file.

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

Cria uma nova instância do tipo indicado definido no arquivo do assembly especificado, determinando se a diferenciação entre maiúsculas e minúsculas é ignorada no nome do tipo; 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.Creates a new instance of the specified type defined in the specified assembly file, specifying whether the case of the type name is ignored; the binding attributes and the binder that are used to select the type to be created; the arguments of the constructor; the culture; and the activation attributes.

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

Cria uma nova instância do tipo especificado definido no arquivo de assembly especificado.Creates a new instance of the specified type defined in the specified assembly file.

CreateInstanceFromAndUnwrap(String, String)

Cria uma nova instância do tipo especificado definido no arquivo de assembly especificado.Creates a new instance of the specified type defined in the specified assembly file.

public:
 System::Object ^ CreateInstanceFromAndUnwrap(System::String ^ assemblyName, System::String ^ typeName);
public object CreateInstanceFromAndUnwrap (string assemblyName, string typeName);
member this.CreateInstanceFromAndUnwrap : string * string -> obj
Public Function CreateInstanceFromAndUnwrap (assemblyName As String, typeName As String) As Object

Parâmetros

assemblyName
String

O nome de arquivo e o caminho do assembly que define o tipo solicitado.The file name and path of the assembly that defines the requested type.

typeName
String

O nome totalmente qualificado do tipo solicitado, inclusive o namespace, mas não o assembly, como retornado pela propriedade FullName.The fully qualified name of the requested type, including the namespace but not the assembly, as returned by the FullName property.

Retornos

O objeto solicitado ou null caso typeName não seja encontrado.The requested object, or null if typeName is not found.

Exceções

assemblyName é null.assemblyName is null.

- ou --or- typeName é null.typeName is null.

A operação é tentada em um domínio de aplicativo descarregado.The operation is attempted on an unloaded application domain.

assemblyName não foi encontrado.assemblyName was not found.

typeName não foi encontrado em assemblyName.typeName was not found in assemblyName.

Não foi encontrado nenhum construtor público sem parâmetros.No parameterless public constructor was found.

O chamador não tem permissão suficiente para chamar esse construtor.The caller does not have sufficient permission to call this constructor.

assemblyName não é um assembly válido.assemblyName is not a valid assembly.

- ou --or- A versão 2,0 ou posterior do Common Language Runtime está carregada e assemblyName foi compilada com uma versão posterior.Version 2.0 or later of the common language runtime is currently loaded and assemblyName was compiled with a later version.

Um assembly ou módulo foi carregado duas vezes em com duas evidências diferentes.An assembly or module was loaded twice with two different evidences.

Comentários

Este é um método prático que combina CreateInstanceFrom e ObjectHandle.Unwrap.This is a convenience method that combines CreateInstanceFrom and ObjectHandle.Unwrap. Esse método chama o construtor sem parâmetros para typeName.This method calls the parameterless constructor for typeName.

Para obter mais informações, consulte o método Activator.CreateInstanceFrom.For more information, see the Activator.CreateInstanceFrom method.

Segurança

FileIOPermissionAccess
para a capacidade de ler o arquivo que contém o manifesto do assembly.for the ability to read the file containing the assembly manifest. Enumeração associada: ReadAssociated enumeration: Read

WebPermission
para a capacidade de acessar o local do conjunto caso o assembly não seja local.for the ability to access the location of the assembly if the assembly is not local.

Veja também

CreateInstanceFromAndUnwrap(String, String, Object[])

Cria uma nova instância do tipo especificado definido no arquivo de assembly especificado.Creates a new instance of the specified type defined in the specified assembly file.

public:
 System::Object ^ CreateInstanceFromAndUnwrap(System::String ^ assemblyName, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);
public object CreateInstanceFromAndUnwrap (string assemblyName, string typeName, object[] activationAttributes);
member this.CreateInstanceFromAndUnwrap : string * string * obj[] -> obj
Public Function CreateInstanceFromAndUnwrap (assemblyName As String, typeName As String, activationAttributes As Object()) As Object

Parâmetros

assemblyName
String

O nome de arquivo e o caminho do assembly que define o tipo solicitado.The file name and path of the assembly that defines the requested type.

typeName
String

O nome totalmente qualificado do tipo solicitado, inclusive o namespace, mas não o assembly (consulte a propriedade FullName).The fully qualified name of the requested type, including the namespace but not the assembly (see the FullName property).

activationAttributes
Object[]

Uma matriz de um ou mais atributos que podem participar da ativação.An array of one or more attributes that can participate in activation. Normalmente, uma matriz que contém um único objeto UrlAttribute que especifica a URL necessária para ativar um objeto remoto.Typically, an array that contains a single UrlAttribute object that specifies the URL that is required to activate a remote object.

Esse parâmetro está relacionado a objetos ativados pelo cliente. A ativação pelo cliente é uma tecnologia herdada, mantida para compatibilidade com versões anteriores, mas não é recomendada para novos desenvolvimentos.This parameter is related to client-activated objects.Client activation is a legacy technology that is retained for backward compatibility but is not recommended for new development. Em vez disso, os aplicativos distribuídos devem usar o Windows Communication Foundation.Distributed applications should instead use Windows Communication Foundation.

Retornos

O objeto solicitado ou null caso typeName não seja encontrado.The requested object, or null if typeName is not found.

Exceções

assemblyName é null.assemblyName is null.

- ou --or- typeName é null.typeName is null.

O chamador não pode fornecer atributos de ativação para um objeto que não seja herdado de MarshalByRefObject.The caller cannot provide activation attributes for an object that does not inherit from MarshalByRefObject.

A operação é tentada em um domínio de aplicativo descarregado.The operation is attempted on an unloaded application domain.

assemblyName não foi encontrado.assemblyName was not found.

typeName não foi encontrado em assemblyName.typeName was not found in assemblyName.

Não foi encontrado nenhum construtor público sem parâmetros.No parameterless public constructor was found.

O chamador não tem permissão suficiente para chamar esse construtor.The caller does not have sufficient permission to call this constructor.

assemblyName não é um assembly válido.assemblyName is not a valid assembly.

- ou --or- A versão 2,0 ou posterior do Common Language Runtime está carregada e assemblyName foi compilada com uma versão posterior.Version 2.0 or later of the common language runtime is currently loaded and assemblyName was compiled with a later version.

Um assembly ou módulo foi carregado duas vezes em com duas evidências diferentes.An assembly or module was loaded twice with two different evidences.

Comentários

Este é um método prático que combina CreateInstanceFrom e ObjectHandle.Unwrap.This is a convenience method that combines CreateInstanceFrom and ObjectHandle.Unwrap. Esse método chama o construtor sem parâmetros para typeName.This method calls the parameterless constructor for typeName.

Para obter mais informações sobre esse método, consulte o método Activator.CreateInstanceFrom.For more information about this method, see the Activator.CreateInstanceFrom method.

Segurança

FileIOPermissionAccess
para a capacidade de ler o arquivo que contém o manifesto do assembly.for the ability to read the file containing the assembly manifest. Enumeração associada: ReadAssociated enumeration: Read

WebPermission
para a capacidade de acessar o local do conjunto caso o assembly não seja local.for the ability to access the location of the assembly if the assembly is not local.

Veja também

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

Cria uma nova instância do tipo indicado definido no arquivo do assembly especificado, determinando se a diferenciação entre maiúsculas e minúsculas é ignorada no nome do tipo; 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.Creates a new instance of the specified type defined in the specified assembly file, specifying whether the case of the type name is ignored; the binding attributes and the binder that are used to select the type to be created; the arguments of the constructor; the culture; and the activation attributes.

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);
member this.CreateInstanceFromAndUnwrap : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> obj

Parâmetros

assemblyFile
String

O nome de arquivo e o caminho do assembly que define o tipo solicitado.The file name and path of the assembly that defines the requested type.

typeName
String

O nome totalmente qualificado do tipo solicitado, inclusive o namespace, mas não o assembly, como retornado pela propriedade FullName.The fully qualified name of the requested type, including the namespace but not the assembly, as returned by the FullName property.

ignoreCase
Boolean

Um valor booliano especificando se é necessário executar uma pesquisa que diferencie maiúsculas de minúsculas ou não.A Boolean value specifying whether to perform a case-sensitive search or not.

bindingAttr
BindingFlags

Uma combinação de zero ou mais sinalizadores de bit que afetam a pesquisa do construtor typeName.A combination of zero or more bit flags that affect the search for the typeName constructor. Caso bindingAttr seja zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos é realizada.If bindingAttr is zero, a case-sensitive search for public constructors is conducted.

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.An object that enables the binding, coercion of argument types, invocation of members, and retrieval of MemberInfo objects through reflection. Caso binder seja nulo, o associador padrão é usado.If binder is null, the default binder is used.

args
Object[]

Os argumentos a serem passados para o construtor.The arguments to pass to the constructor. Esta matriz de argumentos deve corresponder em número, ordem e digitar os parâmetros do construtor a ser invocado.This array of arguments must match in number, order, and type the parameters of the constructor to invoke. Caso haja preferência pelo construtor sem parâmetros, args precisará ser uma matriz vazia ou nulo.If the parameterless constructor is preferred, args must be an empty array or null.

culture
CultureInfo

Informações específicas de cultura que controlam a coerção de args para os tipos formais declarados do construtor typeName.Culture-specific information that governs the coercion of args to the formal types declared for the typeName constructor. Caso culture seja null, CultureInfo para o thread atual é usado.If culture is null, the CultureInfo for the current thread is used.

activationAttributes
Object[]

Uma matriz de um ou mais atributos que podem participar da ativação.An array of one or more attributes that can participate in activation. Normalmente, uma matriz que contém um único objeto UrlAttribute que especifica a URL necessária para ativar um objeto remoto.Typically, an array that contains a single UrlAttribute object that specifies the URL that is required to activate a remote object.

Esse parâmetro está relacionado a objetos ativados pelo cliente.This parameter is related to client-activated objects. A ativação do cliente é uma tecnologia herdada, mantida para compatibilidade com versões anteriores, mas não é recomendada para novos desenvolvimentos.Client activation is a legacy technology that is retained for backward compatibility but is not recommended for new development. Em vez disso, os aplicativos distribuídos devem usar o Windows Communication Foundation.Distributed applications should instead use Windows Communication Foundation.

Retornos

O objeto solicitado ou null caso typeName não seja encontrado.The requested object, or null if typeName is not found.

Exceções

assemblyName é null.assemblyName is null.

- ou --or- typeName é null.typeName is null.

O chamador não pode fornecer atributos de ativação para um objeto que não seja herdado de MarshalByRefObject.The caller cannot provide activation attributes for an object that does not inherit from MarshalByRefObject.

A operação é tentada em um domínio de aplicativo descarregado.The operation is attempted on an unloaded application domain.

assemblyName não foi encontrado.assemblyName was not found.

typeName não foi encontrado em assemblyName.typeName was not found in assemblyName.

Nenhum construtor público correspondente foi encontrado.No matching public constructor was found.

O chamador não tem permissão suficiente para chamar esse construtor.The caller does not have sufficient permission to call this constructor.

assemblyName não é um assembly válido.assemblyName is not a valid assembly.

- ou --or- assemblyName foi compilado com uma versão posterior do Common Language Runtime que a versão carregada atualmente.assemblyName was compiled with a later version of the common language runtime that the version that is currently loaded.

Um assembly ou módulo foi carregado duas vezes em com duas evidências diferentes.An assembly or module was loaded twice with two different evidences.

Comentários

Este é um método prático que combina CreateInstanceFrom e ObjectHandle.Unwrap.This is a convenience method that combines CreateInstanceFrom and ObjectHandle.Unwrap.

Para obter mais informações sobre esse método, consulte o método Activator.CreateInstanceFrom.For more information about this method, see the Activator.CreateInstanceFrom method.

Segurança

FileIOPermissionAccess
para a capacidade de ler o arquivo que contém o manifesto do assembly.for the ability to read the file containing the assembly manifest. Enumeração associada: ReadAssociated enumeration: Read

WebPermission
para a capacidade de acessar o local do conjunto caso o assembly não seja local.for the ability to access the location of the assembly if the assembly is not local.

Veja também

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

Aviso

Esta API agora é obsoleta.

Cria uma nova instância do tipo especificado definido no arquivo de assembly especificado.Creates a new instance of the specified type defined in the specified assembly file.

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);
[System.Obsolete("Use an overload that does not take an Evidence parameter")]
[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 https://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

Parâmetros

assemblyName
String

O nome de arquivo e o caminho do assembly que define o tipo solicitado.The file name and path of the assembly that defines the requested type.

typeName
String

O nome totalmente qualificado do tipo solicitado, inclusive o namespace, mas não o assembly, como retornado pela propriedade FullName.The fully qualified name of the requested type, including the namespace but not the assembly, as returned by the FullName property.

ignoreCase
Boolean

Um valor booliano especificando se é necessário executar uma pesquisa que diferencie maiúsculas de minúsculas ou não.A Boolean value specifying whether to perform a case-sensitive search or not.

bindingAttr
BindingFlags

Uma combinação de zero ou mais sinalizadores de bit que afetam a pesquisa do construtor typeName.A combination of zero or more bit flags that affect the search for the typeName constructor. Caso bindingAttr seja zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos é realizada.If bindingAttr is zero, a case-sensitive search for public constructors is conducted.

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.An object that enables the binding, coercion of argument types, invocation of members, and retrieval of MemberInfo objects through reflection. Caso binder seja nulo, o associador padrão é usado.If binder is null, the default binder is used.

args
Object[]

Os argumentos a serem passados para o construtor.The arguments to pass to the constructor. Esta matriz de argumentos deve corresponder em número, ordem e digitar os parâmetros do construtor a ser invocado.This array of arguments must match in number, order, and type the parameters of the constructor to invoke. Caso haja preferência pelo construtor sem parâmetros, args precisará ser uma matriz vazia ou nulo.If the parameterless constructor is preferred, args must be an empty array or null.

culture
CultureInfo

Informações específicas de cultura que controlam a coerção de args para os tipos formais declarados do construtor typeName.Culture-specific information that governs the coercion of args to the formal types declared for the typeName constructor. Caso culture seja null, CultureInfo para o thread atual é usado.If culture is null, the CultureInfo for the current thread is used.

activationAttributes
Object[]

Uma matriz de um ou mais atributos que podem participar da ativação.An array of one or more attributes that can participate in activation. Normalmente, uma matriz que contém um único objeto UrlAttribute que especifica a URL necessária para ativar um objeto remoto.Typically, an array that contains a single UrlAttribute object that specifies the URL that is required to activate a remote object.

Esse parâmetro está relacionado a objetos ativados pelo cliente.This parameter is related to client-activated objects. A ativação do cliente é uma tecnologia herdada, mantida para compatibilidade com versões anteriores, mas não é recomendada para novos desenvolvimentos.Client activation is a legacy technology that is retained for backward compatibility but is not recommended for new development. Em vez disso, os aplicativos distribuídos devem usar o Windows Communication Foundation.Distributed applications should instead use Windows Communication Foundation.

securityAttributes
Evidence

Informações usadas para autorizar a criação de typeName.Information used to authorize creation of typeName.

Retornos

O objeto solicitado ou null caso typeName não seja encontrado.The requested object, or null if typeName is not found.

Atributos

Exceções

assemblyName é null.assemblyName is null.

- ou --or- typeName é null.typeName is null.

O chamador não pode fornecer atributos de ativação para um objeto que não seja herdado de MarshalByRefObject.The caller cannot provide activation attributes for an object that does not inherit from MarshalByRefObject.

A operação é tentada em um domínio de aplicativo descarregado.The operation is attempted on an unloaded application domain.

assemblyName não foi encontrado.assemblyName was not found.

typeName não foi encontrado em assemblyName.typeName was not found in assemblyName.

Nenhum construtor público correspondente foi encontrado.No matching public constructor was found.

O chamador não tem permissão suficiente para chamar esse construtor.The caller does not have sufficient permission to call this constructor.

assemblyName não é um assembly válido.assemblyName is not a valid assembly.

- ou --or- A versão 2,0 ou posterior do Common Language Runtime está carregada e assemblyName foi compilada com uma versão posterior.Version 2.0 or later of the common language runtime is currently loaded and assemblyName was compiled with a later version.

Um assembly ou módulo foi carregado duas vezes em com duas evidências diferentes.An assembly or module was loaded twice with two different evidences.

Comentários

Este é um método prático que combina CreateInstanceFrom e ObjectHandle.Unwrap.This is a convenience method that combines CreateInstanceFrom and ObjectHandle.Unwrap.

Para obter mais informações sobre esse método, consulte o método Activator.CreateInstanceFrom.For more information about this method, see the Activator.CreateInstanceFrom method.

Segurança

FileIOPermissionAccess
para a capacidade de ler o arquivo que contém o manifesto do assembly.for the ability to read the file containing the assembly manifest. Enumeração associada: ReadAssociated enumeration: Read

WebPermission
para a capacidade de acessar o local do conjunto caso o assembly não seja local.for the ability to access the location of the assembly if the assembly is not local.

Veja também

Aplica-se a