Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

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

.NET Framework (current version)
 

Crea una nueva instancia del tipo especificado definido en el archivo de ensamblado especificado.

Espacio de nombres:   System
Ensamblado:  mscorlib (en mscorlib.dll)

public ObjectHandle CreateInstanceFrom(
	string assemblyFile,
	string typeName,
	bool ignoreCase,
	BindingFlags bindingAttr,
	Binder binder,
	object[] args,
	CultureInfo culture,
	object[] activationAttributes
)

Parámetros

assemblyFile
Type: System.String

Nombre, incluida la ruta de acceso, de un archivo que contiene un ensamblado que define el tipo solicitado. El ensamblado se carga mediante el método LoadFrom.

typeName
Type: System.String

Nombre completo del tipo solicitado, incluido el espacio de nombres, pero no el ensamblado, tal y como lo devuelve la propiedad Type.FullName.

ignoreCase
Type: System.Boolean

Valor booleano que especifica si va a realizarse una búsqueda con distinción de mayúsculas y minúsculas.

bindingAttr
Type: System.Reflection.BindingFlags

Combinación de cero o más marcadores de bits que afectan a la búsqueda del constructor de typeName. Si bindingAttr es cero, se realiza una búsqueda de constructores públicos que distingue mayúsculas de minúsculas.

binder
Type: System.Reflection.Binder

Objeto que permite el enlace, la conversión de tipos de argumentos, la llamada de miembros y la recuperación de objetos MemberInfo mediante reflexión. Si binder es null, se usará el enlazador predeterminado.

args
Type: System.Object[]

Argumentos que se van a pasar al constructor. Esta matriz de argumentos debe coincidir en número, orden y tipo con los parámetros del constructor que se va a invocar. Si se prefiere usar el constructor predeterminado, args debe ser una matriz vacía o null.

culture
Type: System.Globalization.CultureInfo

Información específica de la referencia cultural que controla la conversión de args en los tipos formales declarados para el constructor de typeName. Si culture es null, se usa CultureInfo del subproceso actual.

activationAttributes
Type: System.Object[]

Matriz de uno o más atributos que puede participar en la activación. Normalmente, una matriz que contiene un único objeto UrlAttribute que especifica la dirección URL necesaria para activar un objeto remoto.

Este parámetro está relacionado con los objetos activados por el cliente. La activación por parte del cliente es una tecnología heredada que se conserva por compatibilidad con versiones anteriores, pero no se recomienda para nuevo desarrollo. Las aplicaciones distribuidas deberían usar Windows Communication Foundation.

Valor devuelto

Type: System.Runtime.Remoting.ObjectHandle

Objeto contenedor de la nueva instancia o null, si no se encuentra el parámetro typeName. El valor devuelto debe desempaquetarse para obtener acceso al objeto real.

Exception Condition
ArgumentNullException

El valor de assemblyFile es null.

O bien

El valor de typeName es null.

NotSupportedException

El llamador no puede ofrecer atributos de activación para un objeto que no hereda de MarshalByRefObject.

AppDomainUnloadedException

La operación se intenta en un dominio de aplicación descargado.

FileNotFoundException

No se encontró assemblyFile.

TypeLoadException

No se encontró typeName en assemblyFile.

MissingMethodException

No se encontró ningún constructor público coincidente.

MethodAccessException

El autor de la llamada no tiene permiso suficiente para llamar a este constructor.

BadImageFormatException

assemblyFile no es un ensamblado válido.

-o-

assemblyFile se compiló con una versión de Common Language Runtime posterior a la versión que está cargada actualmente.

FileLoadException

Se cargó un ensamblado o módulo dos veces con dos evidencias diferentes.

NullReferenceException

La instancia es null.

Para obtener más información, vea el método Activator.CreateInstanceFrom.

Cuando el CreateInstanceFrom método se usa para crear una instancia en un dominio de aplicación de destino que no sea el dominio de aplicación desde el que se realiza la llamada, el ensamblado se carga en el dominio de aplicación de destino. Sin embargo, si la instancia está sin ajustar en el dominio de aplicación que realiza la llamada, mediante la instancia sin ajustar en ciertos modos puede provocar que el ensamblado se carga en el dominio de aplicación que realiza la llamada. Por ejemplo, una vez sin ajustar la instancia, se podría solicitar su información de tipo, para poder llamar a sus métodos en tiempo de ejecución. Cuando el ensamblado se carga en el dominio de aplicación que realiza la llamada, se pueden producir excepciones.

  • Si previamente se ha cargado otra versión del mismo ensamblado en el dominio de aplicación que realiza la llamada, o si la ruta de acceso de carga del dominio de aplicación que realiza la llamada es diferente que el dominio de aplicación de destino, las excepciones como MissingMethodException pueden producirse.

  • Si el dominio de aplicación que realiza la llamada realiza llamadas enlazadas tempranamente en el tipo de instancia, InvalidCastException se puede producir cuando se realiza un intento para convertir la instancia.

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.

.NET Framework
Disponible desde 4.0
Volver al principio
Mostrar: