Activator.CreateInstanceFrom Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Crea un'istanza del tipo il cui nome è specificato, utilizzando il file assembly denominato e il costruttore che meglio corrisponde ai parametri specificati.

Overload

CreateInstanceFrom(String, String, Object[])	Crea un'istanza del tipo il cui nome è specificato, utilizzando il file assembly denominato e il costruttore senza parametri.
CreateInstanceFrom(String, String)	Crea un'istanza del tipo il cui nome è specificato, utilizzando il file assembly denominato e il costruttore senza parametri.
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Crea un'istanza del tipo il cui nome è specificato, utilizzando il file assembly denominato e il costruttore che meglio corrisponde ai parametri specificati.

CreateInstanceFrom(String, String, Object[])

Origine:

Activator.cs

Crea un'istanza del tipo il cui nome è specificato, utilizzando il file assembly denominato e il costruttore senza parametri.

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

Parametri

assemblyFile

String

Nome di un file contenente un assembly in cui viene cercato il tipo denominato typeName.

typeName

String

Nome del tipo di cui creare un'istanza.

activationAttributes

Object[]

Matrice di uno o più attributi che possono partecipare all'attivazione. Si tratta in genere di una matrice che contiene un singolo oggetto UrlAttribute che specifica l'URL necessario per attivare un oggetto remoto.

Questo parametro è correlato agli oggetti attivati dal client. L'attivazione client è una tecnologia legacy che viene mantenuta per la compatibilità con le versioni precedenti, ma non è consigliata per il nuovo sviluppo. Le applicazioni distribuite devono invece usare Windows Communication Foundation.

Restituisce

ObjectHandle

Handle che deve essere decomistato per accedere all'oggetto appena creato o null per le istanze di Nullable<T>.

Eccezioni

ArgumentNullException

typeName è null.

MissingMethodException

Non è stato trovato alcun costruttore pubblico corrispondente.

TypeLoadException

typeName non è stato trovato in assemblyFile.

FileNotFoundException

assemblyFile non è stato trovato.

MethodAccessException

Il chiamante non dispone dell'autorizzazione per chiamare questo costruttore.

MemberAccessException

Impossibile creare un'istanza di una classe astratta oppure questo membro è stato richiamato con un meccanismo di associazione tardiva.

TargetInvocationException

Il costruttore, richiamato tramite reflection, ha generato un'eccezione.

NotSupportedException

activationAttributes non è una matrice vuota e il tipo creato non deriva da MarshalByRefObject.

SecurityException

Il chiamante dispone del FileIOPermissionnecessario.

BadImageFormatException

assemblyFile non è un assembly valido.

-o-

Common Language Runtime (CLR) versione 2.0 o successiva è attualmente caricata e assemblyFile è stata compilata per una versione di CLR successiva alla versione attualmente caricata. Si noti che .NET Framework versioni 2.0, 3.0 e 3.5 usano tutti CLR versione 2.0.

Commenti

Utilizzare il metodo ObjectHandle.Unwrap per annullare il wrapping del valore restituito.

Per informazioni su altre eccezioni che possono essere generate dai metodi richiamati, vedere la sezione Eccezioni dei metodi Assembly.LoadFrom e CreateInstance.

CreateInstanceFrom(String, String)

Origine:

Activator.cs

Crea un'istanza del tipo il cui nome è specificato, utilizzando il file assembly denominato e il costruttore senza parametri.

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

Parametri

assemblyFile

String

Nome di un file contenente un assembly in cui viene cercato il tipo denominato typeName.

typeName

String

Nome del tipo di cui creare un'istanza.

Restituisce

ObjectHandle

Handle che deve essere decomistato per accedere all'oggetto appena creato o null per le istanze di Nullable<T>.

Eccezioni

ArgumentNullException

typeName è null.

MissingMethodException

Non è stato trovato alcun costruttore pubblico corrispondente.

TypeLoadException

typeName non è stato trovato in assemblyFile.

FileNotFoundException

assemblyFile non è stato trovato.

MethodAccessException

Il chiamante non dispone dell'autorizzazione per chiamare questo costruttore.

MemberAccessException

Impossibile creare un'istanza di una classe astratta oppure questo membro è stato richiamato con un meccanismo di associazione tardiva.

TargetInvocationException

Il costruttore, richiamato tramite reflection, ha generato un'eccezione.

SecurityException

Il chiamante dispone del FileIOPermissionnecessario.

BadImageFormatException

assemblyFile non è un assembly valido.

-o-

Common Language Runtime (CLR) versione 2.0 o successiva è attualmente caricata e assemblyFile è stata compilata per una versione di CLR successiva alla versione attualmente caricata. Si noti che .NET Framework versioni 2.0, 3.0 e 3.5 usano tutti CLR versione 2.0.

Esempio

Nell'esempio di codice seguente viene illustrato come chiamare il metodo CreateInstanceFrom. Questo esempio di codice fa parte di un esempio più ampio fornito per la classe 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)

Commenti

Utilizzare il metodo ObjectHandle.Unwrap per annullare il wrapping del valore restituito.

Per informazioni su altre eccezioni che possono essere generate dai metodi richiamati, vedere la sezione Eccezioni dei metodi Assembly.LoadFrom e CreateInstance.

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

Origine:

Activator.cs

Crea un'istanza del tipo il cui nome è specificato, utilizzando il file assembly denominato e il costruttore che meglio corrisponde ai parametri specificati.

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

Parametri

assemblyFile

String

Nome di un file contenente un assembly in cui viene cercato il tipo denominato typeName.

typeName

String

Nome del tipo di cui creare un'istanza.

ignoreCase

Boolean

true per specificare che la ricerca di typeName non fa distinzione tra maiuscole e minuscole; false per specificare che la ricerca fa distinzione tra maiuscole e minuscole.

bindingAttr

BindingFlags

Combinazione di zero o più flag di bit che influiscono sulla ricerca del costruttore typeName. Se bindingAttr è zero, viene eseguita una ricerca con distinzione tra maiuscole e minuscole per i costruttori pubblici.

binder

Binder

Oggetto che usa bindingAttr e args per cercare e identificare il costruttore di typeName. Se binder è null, viene usato il gestore di associazione predefinito.

args

Object[]

Matrice di argomenti che corrispondono in numero, ordine e digitare i parametri del costruttore da richiamare. Se args è una matrice vuota o null, viene richiamato il costruttore che non accetta parametri (il costruttore senza parametri).

culture

CultureInfo

Informazioni specifiche delle impostazioni cultura che regolano la coercizione di args ai tipi formali dichiarati per il costruttore typeName. Se culture è null, viene utilizzato il CultureInfo per il thread corrente.

activationAttributes

Object[]

Matrice di uno o più attributi che possono partecipare all'attivazione. Si tratta in genere di una matrice che contiene un singolo oggetto UrlAttribute che specifica l'URL necessario per attivare un oggetto remoto.

Questo parametro è correlato agli oggetti attivati dal client. L'attivazione client è una tecnologia legacy che viene mantenuta per la compatibilità con le versioni precedenti, ma non è consigliata per il nuovo sviluppo. Le applicazioni distribuite devono invece usare Windows Communication Foundation.

Restituisce

ObjectHandle

Handle che deve essere decomistato per accedere all'oggetto appena creato o null per le istanze di Nullable<T>.

Eccezioni

ArgumentNullException

typeName è null.

MissingMethodException

Non è stato trovato alcun costruttore corrispondente.

TypeLoadException

typeName non è stato trovato in assemblyFile.

FileNotFoundException

assemblyFile non è stato trovato.

MethodAccessException

Il chiamante non dispone dell'autorizzazione per chiamare questo costruttore.

MemberAccessException

Impossibile creare un'istanza di una classe astratta oppure questo membro è stato richiamato con un meccanismo di associazione tardiva.

TargetInvocationException

Il costruttore, richiamato tramite reflection, ha generato un'eccezione.

SecurityException

Il chiamante non dispone del FileIOPermissionnecessario.

NotSupportedException

activationAttributes non è una matrice vuota e il tipo creato non deriva da MarshalByRefObject.

BadImageFormatException

assemblyFile non è un assembly valido.

-o-

Common Language Runtime (CLR) versione 2.0 o successiva è attualmente caricata e assemblyFile è stata compilata per una versione di CLR successiva alla versione attualmente caricata. Si noti che .NET Framework versioni 2.0, 3.0 e 3.5 usano tutti CLR versione 2.0.

Commenti

Utilizzare il metodo ObjectHandle.Unwrap per annullare il wrapping del valore restituito.

Per informazioni su altre eccezioni che possono essere generate dai metodi richiamati, vedere la sezione Eccezioni dei metodi Assembly.LoadFrom e CreateInstance.