Activator.CreateInstanceFrom Método

Definición

Espacio de nombres:

System

Ensamblados:

netstandard.dll, System.Runtime.dll

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

Sobrecargas

Nombre	Description
CreateInstanceFrom(String, String, Object[])	Crea una instancia del tipo cuyo nombre se especifica, utilizando el archivo de ensamblado con nombre y el constructor sin parámetros.
CreateInstanceFrom(String, String)	Crea una instancia del tipo cuyo nombre se especifica, utilizando 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, utilizando el archivo de ensamblado con nombre y el constructor que mejor coincide con los parámetros especificados.

CreateInstanceFrom(String, String, Object[])

Source:

Activator.cs

Crea una instancia del tipo cuyo nombre se especifica, utilizando 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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")]
public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom(string assemblyFile, string typeName, object?[]? activationAttributes);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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 de .

activationAttributes

Object[]

Matriz de uno o varios atributos que pueden participar en la activación. Normalmente, se trata de una matriz que contiene un único UrlAttribute objeto 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 de cliente es una tecnología heredada que se conserva para la compatibilidad con versiones anteriores, pero no se recomienda para el nuevo desarrollo. En su lugar, las aplicaciones distribuidas deben 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, .

Atributos

RequiresUnreferencedCodeAttribute

Excepciones

ArgumentNullException

typeName es null.

MissingMethodException

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

TypeLoadException

typeName no se encontró en assemblyFile.

FileNotFoundException

no se encontró assemblyFile.

MethodAccessException

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

MemberAccessException

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

TargetInvocationException

El constructor, que se invocó a través de la reflexión, produjo una excepción.

NotSupportedException

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

SecurityException

El autor de la llamada tiene el requerido FileIOPermission.

BadImageFormatException

assemblyFile no es un ensamblado válido.

O bien

La versión 2.0 o posterior de Common Language Runtime (CLR) está cargada actualmente y assemblyFile se compiló para una versión de CLR que es 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, utilizando 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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")]
public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom(string assemblyFile, string typeName);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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 de .

Devoluciones

ObjectHandle

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

Atributos

RequiresUnreferencedCodeAttribute

Excepciones

ArgumentNullException

typeName es null.

MissingMethodException

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

TypeLoadException

typeName no se encontró en assemblyFile.

FileNotFoundException

no se encontró assemblyFile.

MethodAccessException

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

MemberAccessException

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

TargetInvocationException

El constructor, que se invocó a través de la reflexión, produjo una excepción.

SecurityException

El autor de la llamada tiene el requerido FileIOPermission.

BadImageFormatException

assemblyFile no es un ensamblado válido.

O bien

La versión 2.0 o posterior de Common Language Runtime (CLR) está cargada actualmente y assemblyFile se compiló para una versión de CLR que es 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 forma parte de un ejemplo más grande proporcionado para la Activator clase .

// 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, utilizando el archivo de ensamblado con nombre y el constructor que mejor coincide 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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")]
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);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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 de .

ignoreCase

Boolean

true para especificar que la búsqueda typeName no distingue mayúsculas de minúsculas; false para especificar que la búsqueda distingue mayúsculas de minúsculas.

bindingAttr

BindingFlags

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

binder

Binder

Objeto que usa bindingAttr y args para buscar e identificar el typeName constructor. Si binder es null, se usa el enlazador predeterminado.

args

Object[]

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

culture

CultureInfo

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

activationAttributes

Object[]

Matriz de uno o varios atributos que pueden participar en la activación. Normalmente, se trata de una matriz que contiene un único UrlAttribute objeto 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 de cliente es una tecnología heredada que se conserva para la compatibilidad con versiones anteriores, pero no se recomienda para el nuevo desarrollo. En su lugar, las aplicaciones distribuidas deben 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, .

Atributos

RequiresUnreferencedCodeAttribute

Excepciones

ArgumentNullException

typeName es null.

MissingMethodException

No se encontró ningún constructor coincidente.

TypeLoadException

typeName no se encontró en assemblyFile.

FileNotFoundException

no se encontró assemblyFile.

MethodAccessException

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

MemberAccessException

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

TargetInvocationException

El constructor, que se invocó a través de la reflexión, produjo una excepción.

SecurityException

El autor de la llamada no tiene el requerido FileIOPermission.

NotSupportedException

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

BadImageFormatException

assemblyFile no es un ensamblado válido.

O bien

La versión 2.0 o posterior de Common Language Runtime (CLR) está cargada actualmente y assemblyFile se compiló para una versión de CLR que es 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 .