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.CreateInstance (String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

 

Publicado: julio de 2016

obsoleteCodeEntityM:System.AppDomain.CreateInstance(System.String,System.String,System.Boolean,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo,System.Object[]) Nota: Esta API ahora está obsoleta.

Crea una nueva instancia del tipo especificado definido en el ensamblado especificado. Los parámetros establecen un enlazador, marcas de enlace, argumentos de constructor, información específica de la referencia cultural usada para interpretar argumentos, atributos de activación y autorización para crear el tipo.

Espacio de nombres:   System
Ensamblado:  mscorlib (en 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 CreateInstance which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public ObjectHandle CreateInstance(
	string assemblyName,
	string typeName,
	bool ignoreCase,
	BindingFlags bindingAttr,
	Binder binder,
	object[] args,
	CultureInfo culture,
	object[] activationAttributes,
	Evidence securityAttributes
)

Parámetros

assemblyName
Type: System.String

Nombre para mostrar del ensamblado. Vea Assembly.FullName.

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 invocación de miembros y la recuperación de objetos MemberInfo mediante la 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. Activación 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.

securityAttributes
Type: System.Security.Policy.Evidence

Información que se usa para autorizar la creación de typeName.

Valor devuelto

Type: System.Runtime.Remoting.ObjectHandle

Objeto contenedor de la nueva instancia especificada por typeName. El valor devuelto debe desempaquetarse para obtener acceso al objeto real.

Exception Condition
AppDomainUnloadedException

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

ArgumentNullException

El valor de assemblyName o typeName es null.

BadImageFormatException

assemblyName no es un ensamblado válido.

-o-

La versión 2.0 u otra posterior del Common Language Runtime está cargada actualmente y assemblyName se compiló con una versión posterior.

FileLoadException

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

FileNotFoundException

No se encontró assemblyName.

MethodAccessException

El llamador no tiene permiso para llamar a este constructor.

MissingMethodException

No se encontró ningún constructor coincidente.

NotSupportedException

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

-o-

securityAttributes no es null. Cuando no se habilita la directiva CAS heredada, securityAttributes debe sernull.

TypeLoadException

No se encontró typename en assemblyName.

NullReferenceException

La instancia es null.

Vea AssemblyName para el formato de assemblyName.

Un intento de llamar a CreateInstance en un destino de dominio de aplicación que no sea el dominio de aplicación actual se producirá en una carga correcta del ensamblado en el dominio de aplicación de destino. Puesto que un Assembly no MarshalByRefObject, cuando este método intente devolver la Assembly para el ensamblado cargado en el dominio de aplicación actual, common language runtime intentará cargar el ensamblado en el dominio de aplicación actual y puede producir un error en la carga. El ensamblado que se carga en el dominio de aplicación actual podría ser distinto del ensamblado que se cargó en primer lugar si la configuración de ruta de acceso para los dos dominios de aplicación es diferente.

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

for the ability to call unmanaged code when creating an instance of a delegate. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode

ReflectionPermission

for the ability to invoke operations on all type members. Associated enumeration: F:System.Security.Permissions.ReflectionPermissionFlag.MemberAccess

SecurityPermission

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

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: