Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

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

Observação: esta API agora é obsoleta. A alternativa não obsoleta é CreateInstanceFrom.

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
Tipo: 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
Tipo: System.String
O nome totalmente qualificado do tipo solicitado, inclusive o namespace, mas não o assembly, como retornado pela propriedade Type.FullName.
ignoreCase
Tipo: System.Boolean
Um valor booliano especificando se é necessário executar uma pesquisa que diferencie maiúsculas de minúsculas ou não.
bindingAttr
Tipo: 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
Tipo: 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
Tipo: 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
Tipo: 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
Tipo: 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. O UrlAttribute especifica a URL necessária para ativar um objeto remoto.
securityAttributes
Tipo: System.Security.Policy.Evidence
Informações usadas para autorizar a criação de typeName.

Valor de retorno

Tipo: 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.

Implementações

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

ExceçãoCondição
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.

O parâmetro activationAttributes está relacionado a objetos ativados pelo cliente; consulte Client Activation.

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.

.NET Framework

Com suporte em: 3.5, 3.0, 2.0, 1.1, 1.0
Obsoleto (aviso do compilador) em 4.5.2
Obsoleto (aviso do compilador) em 4.5.1
Obsoleto (aviso do compilador) em 4.5
Obsoleto (aviso do compilador) em 4

.NET Framework Client Profile

Com suporte em: 3.5 SP1
Obsoleto (aviso do compilador) em 4

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft