Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método AppDomain.CreateInstanceFrom (String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

 
obsoleteCodeEntityM:System.AppDomain.CreateInstanceFrom(System.String,System.String,System.Boolean,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo,System.Object[]) Observação: Esta API agora está obsoleta.

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

Namespace:   System
Assembly:  mscorlib (em mscorlib.dll)

[ObsoleteAttribute("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 ObjectHandle CreateInstanceFrom(
	string assemblyFile,
	string typeName,
	bool ignoreCase,
	BindingFlags bindingAttr,
	Binder binder,
	object[] args,
	CultureInfo culture,
	object[] activationAttributes,
	Evidence securityAttributes
)

Parâmetros

assemblyFile
Type: System.String

O nome, inclusive o caminho, de um arquivo que contém um assembly que define o tipo solicitado. O assembly é carregado usando-se o método LoadFrom.

typeName
Type: System.String

O nome totalmente qualificado do tipo solicitado, inclusive o namespace, mas não o assembly, como retornado pela propriedade Type.FullName.

ignoreCase
Type: System.Boolean

Um valor booliano especificando se é necessário executar uma pesquisa que diferencie maiúsculas de minúsculas ou não.

bindingAttr
Type: System.Reflection.BindingFlags

Uma combinação de zero ou mais sinalizadores de bit que afetam a pesquisa do construtor typeName. Caso bindingAttr seja zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos é realizada.

binder
Type: System.Reflection.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. Caso binder seja nulo, o associador padrão é usado.

args
Type: System.Object[]

Os argumentos a serem passados para o construtor. Esta matriz de argumentos deve corresponder em número, ordem e digitar os parâmetros do construtor a ser invocado. Caso o construtor padrão seja preferido, args deve ser uma matriz vazia ou nula.

culture
Type: System.Globalization.CultureInfo

Informações específicas de cultura que controlam a coerção de args para os tipos formais declarados do construtor typeName. Caso culture seja null, CultureInfo para o thread atual é usado.

activationAttributes
Type: System.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, mantida para compatibilidade com versões anteriores, mas não é recomendada para novos desenvolvimentos. Em vez disso, os aplicativos distribuídos devem usar o Windows Communication Foundation.

securityAttributes
Type: System.Security.Policy.Evidence

Informações usadas para autorizar a criação de typeName.

Valor Retornado

Type: System.Runtime.Remoting.ObjectHandle

Um objeto que é um wrapper para a nova instância ou null caso typeName não seja encontrado. O valor de retorno precisa ser desencapsulado para acessar o objeto real.

Exception Condition
ArgumentNullException

assemblyFile é null.

-ou-

typeName é null.

NotSupportedException

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

-ou-

securityAttributes não é null. Quando a política CAS herdada não está habilitada, securityAttributes deve ser null.

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-

A versão 2,0 ou posterior do Common Language Runtime está carregada e assemblyFile foi compilada com uma versão posterior.

FileLoadException

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

NullReferenceException

Esta instância é null.

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

Quando o método CreateInstanceFrom é usado para criar uma instância em um domínio de aplicativo de destino, outro que não seja o domínio de aplicativo do qual a chamada é feita, o assembly é carregado no domínio de aplicativo de destino. No entanto, caso a instância seja desencapsulada no domínio do aplicativo de chamada, o uso da instância desencapsulada de determinadas formas pode fazer o assembly ser carregado no domínio do aplicativo de chamada. Por exemplo, depois da instância ser desencapsulada, as informações de tipo poderão ser solicitadas, para chamar a associação tardia dos métodos. Quando o assembly é carregado no domínio de aplicativo de chamada, podem ocorrer exceções.

  • Caso outra versão do mesmo assembly tenha sido carregada anteriormente no domínio do aplicativo de chamada ou caso o caminho de carregamento do domínio de aplicativo de chamada seja diferente do domínio do aplicativo de destino, exceções como MissingMethodException podem ocorrer.

  • Caso o domínio do aplicativo de chamada faça chamadas Early Bound para o tipo de instância, InvalidCastException pode ser lançado quando uma tentativa é feita para converter a instância.

FileIOPermissionAccess

for the ability to access the location of the assembly. Associated enumeration: F:System.Security.Permissions.FileIOPermissionAccess.PathDiscovery

FileIOPermissionAccess

for the ability to read the file containing the assembly manifest. Associated enumeration: F:System.Security.Permissions.FileIOPermissionAccess.Read

WebPermission

for the ability to access the location of the assembly if the assembly is not local.

SecurityPermission

to provide evidence. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.ControlEvidence.

.NET Framework
Disponível desde 1.1
Retornar ao início
Mostrar: