AppDomain.CreateInstance Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea una nueva instancia de un tipo especificado definido en un ensamblado especificado.
Sobrecargas
| CreateInstance(String, String) |
Crea una nueva instancia del tipo especificado definido en el ensamblado especificado. |
| CreateInstance(String, String, Object[]) |
Crea una nueva instancia del tipo especificado definido en el ensamblado especificado. Un parámetro especifica una matriz de atributos de activación. |
| CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[]) |
Crea una nueva instancia del tipo especificado definido en el ensamblado especificado. Los parámetros especifican un enlazador, marcas de enlace, argumentos de constructor, información específica de la referencia cultural usada para interpretar argumentos y atributos de activación opcionales. |
| CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence) |
Obsoletos.
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. |
CreateInstance(String, String)
- Source:
- AppDomain.cs
- Source:
- AppDomain.cs
- Source:
- AppDomain.cs
Crea una nueva instancia del tipo especificado definido en el ensamblado especificado.
public:
System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName);public:
virtual System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName);public System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName);public System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName);member this.CreateInstance : string * string -> System.Runtime.Remoting.ObjectHandleabstract member CreateInstance : string * string -> System.Runtime.Remoting.ObjectHandle
override this.CreateInstance : string * string -> System.Runtime.Remoting.ObjectHandlePublic Function CreateInstance (assemblyName As String, typeName As String) As ObjectHandleParámetros
- typeName
- String
Nombre completo del tipo solicitado, incluido el espacio de nombres, pero no el ensamblado, tal y como lo devuelve la propiedad FullName.
Devoluciones
Objeto contenedor de la nueva instancia especificada por typeName. El valor devuelto debe desempaquetarse para obtener acceso al objeto real.
Implementaciones
Excepciones
La operación se intenta en un dominio de aplicación descargado.
assemblyName o typeName es null.
assemblyName no es un ensamblado válido para el tiempo de ejecución cargado actualmente.
Se cargó un ensamblado o módulo dos veces con dos evidencias diferentes.
No se encontró assemblyName.
El llamador no tiene permiso para llamar a este constructor.
No se encontró ningún constructor público coincidente.
No se encontró typename en assemblyName.
La instancia es null.
Comentarios
Este método llama al constructor sin parámetros para typeName.
Vea AssemblyName para obtener el formato de assemblyName.
Un intento de llamar CreateInstance a en un dominio de aplicación de destino que no sea el dominio de aplicación actual dará como resultado una carga correcta del ensamblado en el dominio de aplicación de destino. Puesto que no AssemblyMarshalByRefObjectes , cuando este método intenta devolver para Assembly el ensamblado cargado al dominio de aplicación actual, Common Language Runtime intentará cargar el ensamblado en el dominio de aplicación actual y la carga podría producir un error. El ensamblado que se carga en el dominio de aplicación actual podría ser diferente del ensamblado que se cargó primero si la configuración de ruta de acceso de los dos dominios de aplicación es diferente.
Consulte también
Se aplica a
CreateInstance(String, String, Object[])
- Source:
- AppDomain.cs
- Source:
- AppDomain.cs
- Source:
- AppDomain.cs
Crea una nueva instancia del tipo especificado definido en el ensamblado especificado. Un parámetro especifica una matriz de atributos de activación.
public:
System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);public:
virtual System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);public System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName, object?[]? activationAttributes);public System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName, object[] activationAttributes);member this.CreateInstance : string * string * obj[] -> System.Runtime.Remoting.ObjectHandleabstract member CreateInstance : string * string * obj[] -> System.Runtime.Remoting.ObjectHandle
override this.CreateInstance : string * string * obj[] -> System.Runtime.Remoting.ObjectHandlePublic Function CreateInstance (assemblyName As String, typeName As String, activationAttributes As Object()) As ObjectHandleParámetros
- typeName
- String
Nombre completo del tipo solicitado, incluido el espacio de nombres, pero no el ensamblado, tal y como lo devuelve la propiedad FullName.
- activationAttributes
- 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 para la compatibilidad con versiones anteriores, pero no se recomienda para nuevo desarrollo. Las aplicaciones distribuidas deberían usar Windows Communication Foundation.
Devoluciones
Objeto contenedor de la nueva instancia especificada por typeName. El valor devuelto debe desempaquetarse para obtener acceso al objeto real.
Implementaciones
Excepciones
La operación se intenta en un dominio de aplicación descargado.
assemblyName o typeName es null.
assemblyName no es un ensamblado válido para el tiempo de ejecución cargado actualmente.
Se cargó un ensamblado o módulo dos veces con dos evidencias diferentes.
No se encontró assemblyName.
El llamador no tiene permiso para llamar a este constructor.
No se encontró ningún constructor público coincidente.
El llamador no puede ofrecer atributos de activación para un objeto que no hereda de MarshalByRefObject.
No se encontró typename en assemblyName.
La instancia es null.
Comentarios
Este método llama al constructor sin parámetros para typeName.
Vea AssemblyName para obtener el formato de assemblyName.
Un intento de llamar CreateInstance a en un dominio de aplicación de destino que no sea el dominio de aplicación actual dará como resultado una carga correcta del ensamblado en el dominio de aplicación de destino. Puesto que no AssemblyMarshalByRefObjectes , cuando este método intenta devolver para Assembly el ensamblado cargado al dominio de aplicación actual, Common Language Runtime intentará cargar el ensamblado en el dominio de aplicación actual y la carga podría producir un error. El ensamblado que se carga en el dominio de aplicación actual podría ser diferente del ensamblado que se cargó primero si la configuración de ruta de acceso de los dos dominios de aplicación es diferente.
Consulte también
Se aplica a
CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])
- Source:
- AppDomain.cs
- Source:
- AppDomain.cs
- Source:
- AppDomain.cs
Crea una nueva instancia del tipo especificado definido en el ensamblado especificado. Los parámetros especifican un enlazador, marcas de enlace, argumentos de constructor, información específica de la referencia cultural usada para interpretar argumentos y atributos de activación opcionales.
public:
System::Runtime::Remoting::ObjectHandle ^ CreateInstance(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);public System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);public System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);member this.CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandlePublic Function CreateInstance (assemblyName As String, typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object()) As ObjectHandleParámetros
- typeName
- String
Nombre completo del tipo solicitado, incluido el espacio de nombres, pero no el ensamblado, tal y como lo devuelve la propiedad FullName.
- ignoreCase
- Boolean
Valor booleano que especifica si va a realizarse una búsqueda con distinción de mayúsculas y minúsculas.
- bindingAttr
- 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
- 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
- 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 sin parámetros, args debe ser una matriz vacía o null.
- culture
- 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
- 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.
Devoluciones
Objeto contenedor de la nueva instancia especificada por typeName. El valor devuelto debe desempaquetarse para obtener acceso al objeto real.
Excepciones
La operación se intenta en un dominio de aplicación descargado.
assemblyName o typeName es null.
assemblyName no es un ensamblado válido para el tiempo de ejecución cargado actualmente.
Se cargó un ensamblado o módulo dos veces con dos evidencias diferentes.
No se encontró assemblyName.
El llamador no tiene permiso para llamar a este constructor.
No se encontró ningún constructor coincidente.
El llamador no puede ofrecer atributos de activación para un objeto que no hereda de MarshalByRefObject.
No se encontró typename en assemblyName.
La instancia es null.
Comentarios
Vea AssemblyName para obtener el formato de assemblyName.
Un intento de llamar CreateInstance a en un dominio de aplicación de destino que no sea el dominio de aplicación actual dará como resultado una carga correcta del ensamblado en el dominio de aplicación de destino. Puesto que no AssemblyMarshalByRefObjectes , cuando este método intenta devolver para Assembly el ensamblado cargado al dominio de aplicación actual, Common Language Runtime intentará cargar el ensamblado en el dominio de aplicación actual y la carga podría producir un error. El ensamblado que se carga en el dominio de aplicación actual podría ser diferente del ensamblado que se cargó primero si la configuración de ruta de acceso de los dos dominios de aplicación es diferente.
Consulte también
Se aplica a
CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)
Precaución
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.
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.
public:
virtual System::Runtime::Remoting::ObjectHandle ^ CreateInstance(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);public System.Runtime.Remoting.ObjectHandle CreateInstance (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);[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 CreateInstance which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public System.Runtime.Remoting.ObjectHandle CreateInstance (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);abstract member CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle
override this.CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle[<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 CreateInstance which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
abstract member CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle
override this.CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandlePublic Function CreateInstance (assemblyName As String, typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object(), securityAttributes As Evidence) As ObjectHandleParámetros
- typeName
- String
Nombre completo del tipo solicitado, incluido el espacio de nombres, pero no el ensamblado, tal y como lo devuelve la propiedad FullName.
- ignoreCase
- Boolean
Valor booleano que especifica si va a realizarse una búsqueda con distinción de mayúsculas y minúsculas.
- bindingAttr
- 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
- 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
- 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 sin parámetros, args debe ser una matriz vacía o null.
- culture
- 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
- 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 para la compatibilidad con versiones anteriores, pero no se recomienda para nuevo desarrollo. Las aplicaciones distribuidas deberían usar Windows Communication Foundation.
- securityAttributes
- Evidence
Información que se usa para autorizar la creación de typeName.
Devoluciones
Objeto contenedor de la nueva instancia especificada por typeName. El valor devuelto debe desempaquetarse para obtener acceso al objeto real.
Implementaciones
- Atributos
Excepciones
La operación se intenta en un dominio de aplicación descargado.
assemblyName o typeName es null.
assemblyName no es un ensamblado válido para el entorno de ejecución cargado actualmente.
Se cargó un ensamblado o módulo dos veces con dos evidencias diferentes.
No se encontró assemblyName.
El llamador no tiene permiso para llamar a este constructor.
No se encontró ningún constructor coincidente.
El llamador no puede ofrecer atributos de activación para un objeto que no hereda de MarshalByRefObject.
o bien
securityAttributes no es null. Si la directiva CAS heredada no está habilitada, securityAttributes debería ser null
No se encontró typename en assemblyName.
La instancia es null.
Comentarios
Consulte AssemblyName para obtener el formato de assemblyName.
Un intento de llamar CreateInstance a en un dominio de aplicación de destino que no sea el dominio de aplicación actual dará como resultado una carga correcta del ensamblado en el dominio de aplicación de destino. Dado que no AssemblyMarshalByRefObjectes , cuando este método intenta devolver el Assembly para el ensamblado cargado al dominio de aplicación actual, Common Language Runtime intentará cargar el ensamblado en el dominio de aplicación actual y podría producir un error en la carga. El ensamblado que se carga en el dominio de aplicación actual podría ser diferente del ensamblado que se cargó primero si la configuración de ruta de acceso de los dos dominios de aplicación es diferente.
Consulte también
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de