Activator.CreateInstanceFrom Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Crea una instancia del tipo cuyo nombre se especifica, usando el archivo de ensamblado con nombre y el constructor que mejor coincida con los parámetros especificados.

Sobrecargas

CreateInstanceFrom(String, String, Object[])	Crea una instancia del tipo cuyo nombre se especifica, usando el archivo de ensamblado con nombre y el constructor sin parámetros.
CreateInstanceFrom(String, String)	Crea una instancia del tipo cuyo nombre se especifica, usando el archivo de ensamblado con nombre y el constructor sin parámetros.
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Crea una instancia del tipo cuyo nombre se especifica, usando el archivo de ensamblado con nombre y el constructor que mejor coincida con los parámetros especificados.

CreateInstanceFrom(String, String, Object[])

Source:

Activator.cs

Crea una instancia del tipo cuyo nombre se especifica, usando el archivo de ensamblado con nombre y el constructor sin parámetros.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);

public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName, object?[]? activationAttributes);

static member CreateInstanceFrom : string * string * obj[] -> System.Runtime.Remoting.ObjectHandle

Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String, activationAttributes As Object()) As ObjectHandle

Parámetros

assemblyFile

String

Nombre de un archivo que contiene un ensamblado donde se busca el tipo denominado typeName.

typeName

String

Nombre del tipo del que se va a crear una instancia.

activationAttributes

Object[]

Matriz de uno o más atributos que puede participar en la activación. Normalmente, se trata de 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

ObjectHandle

Identificador que se debe desencapsular para tener acceso al objeto recién creado o null , por Nullable<T> ejemplo, .

Excepciones

ArgumentNullException

typeName es null.

MissingMethodException

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

TypeLoadException

No se encontró typename en assemblyFile.

FileNotFoundException

No se encontró assemblyFile.

MethodAccessException

El llamador no tiene permiso para llamar a este constructor.

MemberAccessException

No se puede crear una instancia de una clase abstracta o este miembro se invocó mediante un mecanismo de enlace en tiempo de ejecución.

TargetInvocationException

El constructor, que se invocó mediante reflexión, inició una excepción.

NotSupportedException

activationAttributes no es una matriz vacía y el tipo que se está creando no se deriva de MarshalByRefObject.

SecurityException

El llamador no dispone del permiso FileIOPermission requerido.

BadImageFormatException

assemblyFile no es un ensamblado válido.

o bien

Common Language Runtime (CLR) 2.0 o una versión posterior está cargado actualmente y assemblyName se compiló para una versión de CLR posterior a la versión cargada actualmente. Tenga en cuenta que las versiones 2.0, 3.0 y 3.5 de .NET Framework usan CLR versión 2.0.

Comentarios

Use el ObjectHandle.Unwrap método para desencapsular el valor devuelto.

Para obtener información sobre otras excepciones que se pueden producir mediante métodos invocados, vea la sección Excepciones de los Assembly.LoadFrom métodos y CreateInstance .

CreateInstanceFrom(String, String)

Source:

Activator.cs

Crea una instancia del tipo cuyo nombre se especifica, usando el archivo de ensamblado con nombre y el constructor sin parámetros.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName);

public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName);

static member CreateInstanceFrom : string * string -> System.Runtime.Remoting.ObjectHandle

Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String) As ObjectHandle

Parámetros

assemblyFile

String

Nombre de un archivo que contiene un ensamblado donde se busca el tipo denominado typeName.

typeName

String

Nombre del tipo del que se va a crear una instancia.

Devoluciones

ObjectHandle

Identificador que se debe desencapsular para tener acceso al objeto recién creado o null , por Nullable<T> ejemplo, .

Excepciones

ArgumentNullException

typeName es null.

MissingMethodException

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

TypeLoadException

No se encontró typename en assemblyFile.

FileNotFoundException

No se encontró assemblyFile.

MethodAccessException

El llamador no tiene permiso para llamar a este constructor.

MemberAccessException

No se puede crear una instancia de una clase abstracta o este miembro se invocó mediante un mecanismo de enlace en tiempo de ejecución.

TargetInvocationException

El constructor, que se invocó mediante reflexión, inició una excepción.

SecurityException

El llamador no dispone del permiso FileIOPermission requerido.

BadImageFormatException

assemblyFile no es un ensamblado válido.

o bien

Common Language Runtime (CLR) 2.0 o una versión posterior está cargado actualmente y assemblyName se compiló para una versión de CLR posterior a la versión cargada actualmente. Tenga en cuenta que las versiones 2.0, 3.0 y 3.5 de .NET Framework usan CLR versión 2.0.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar al CreateInstanceFrom método . Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase Activator.

// Create an instance of the SomeType class that is defined in this 
// assembly.
System::Runtime::Remoting::ObjectHandle^ oh = 
    Activator::CreateInstanceFrom(Assembly::GetEntryAssembly()->CodeBase, 
                                  SomeType::typeid->FullName);

// Call an instance method defined by the SomeType type using this object.
SomeType^ st = (SomeType^) oh->Unwrap();

st->DoSomething(5);

// Create an instance of the SomeType class that is defined in this
// assembly.
System.Runtime.Remoting.ObjectHandle oh =
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase,
                                 typeof(SomeType).FullName);

// Call an instance method defined by the SomeType type using this object.
SomeType st = (SomeType) oh.Unwrap();

st.DoSomething(5);

// Create an instance of the SomeType class that is defined in this assembly.
let oh = 
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().Location, typeof<SomeType>.FullName)

// Call an instance method defined by the SomeType type using this object.
let st = oh.Unwrap() :?> SomeType

st.DoSomething 5

' Create an instance of the SomeType class that is defined in this assembly.
Dim oh As System.Runtime.Remoting.ObjectHandle = _
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase, _
                                 GetType(SomeType).FullName)

' Call an instance method defined by the SomeType type using this object.
Dim st As SomeType = CType(oh.Unwrap(), SomeType)

st.DoSomething(5)

Comentarios

Use el ObjectHandle.Unwrap método para desencapsular el valor devuelto.

Para obtener información sobre otras excepciones que se pueden producir mediante métodos invocados, vea la sección Excepciones de los Assembly.LoadFrom métodos y CreateInstance .

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

Source:

Activator.cs

Crea una instancia del tipo cuyo nombre se especifica, usando el archivo de ensamblado con nombre y el constructor que mejor coincida con los parámetros especificados.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, 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 static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);

static member CreateInstanceFrom : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandle

Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object()) As ObjectHandle

Parámetros

assemblyFile

String

Nombre de un archivo que contiene un ensamblado donde se busca el tipo denominado typeName.

typeName

String

Nombre del tipo del que se va a crear una instancia.

ignoreCase

Boolean

true para especificar que en la búsqueda de typeName no se distingue entre mayúsculas y minúsculas; false para especificar que en la búsqueda se tenga en cuenta el uso 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 usa bindingAttr y args para buscar e identificar el constructor de typeName. Si binder es null, se usa el enlazador predeterminado.

args

Object[]

Matriz de argumentos que coinciden en número, orden y tipo con los parámetros del constructor al que se va a invocar. Si args es una matriz vacía o null, se invoca al constructor que no toma parámetros (constructor sin parámetros).

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, se trata de 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

ObjectHandle

Identificador que se debe desencapsular para tener acceso al objeto recién creado o null para Nullable<T> instancias.

Excepciones

ArgumentNullException

typeName es null.

MissingMethodException

No se encontró ningún constructor coincidente.

TypeLoadException

No se encontró typename en assemblyFile.

FileNotFoundException

No se encontró assemblyFile.

MethodAccessException

El llamador no tiene permiso para llamar a este constructor.

MemberAccessException

No se puede crear una instancia de una clase abstracta o este miembro se invocó mediante un mecanismo de enlace en tiempo de ejecución.

TargetInvocationException

El constructor, que se invocó mediante reflexión, inició una excepción.

SecurityException

El llamador no dispone del permiso FileIOPermission requerido.

NotSupportedException

activationAttributes no es una matriz vacía y el tipo que se está creando no se deriva de MarshalByRefObject.

BadImageFormatException

assemblyFile no es un ensamblado válido.

o bien

Common Language Runtime (CLR) 2.0 o una versión posterior está cargado actualmente y assemblyName se compiló para una versión de CLR posterior a la versión cargada actualmente. Tenga en cuenta que las versiones 2.0, 3.0 y 3.5 de .NET Framework usan CLR versión 2.0.

Comentarios

Use el ObjectHandle.Unwrap método para desencapsular el valor devuelto.

Para obtener información sobre otras excepciones que se pueden producir mediante métodos invocados, vea la sección Excepciones de los Assembly.LoadFrom métodos y CreateInstance .