Activator.CreateInstanceFrom Metodo

Definizione

Spazio dei nomi:

System

Assembly:

netstandard.dll, 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

Nome	Descrizione
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);

[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

Parametri

assemblyFile

String

Nome di un file che contiene 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 UrlAttribute oggetto 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.

Valori restituiti

ObjectHandle

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

Attributi

RequiresUnreferencedCodeAttribute

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 dell'oggetto richiesto FileIOPermission.

BadImageFormatException

assemblyFile non è un assembly valido.

oppure

Common Language Runtime (CLR) versione 2.0 o successiva è attualmente caricato ed assemblyFile è stato compilato 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 ObjectHandle.Unwrap metodo per annullare il wrapping del valore restituito.

Per informazioni su altre eccezioni che possono essere generate dai metodi richiamati, vedere la sezione Eccezioni dei Assembly.LoadFrom metodi 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);

[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

Parametri

assemblyFile

String

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

typeName

String

Nome del tipo di cui creare un'istanza.

Valori restituiti

ObjectHandle

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

Attributi

RequiresUnreferencedCodeAttribute

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 dell'oggetto richiesto FileIOPermission.

BadImageFormatException

assemblyFile non è un assembly valido.

oppure

Common Language Runtime (CLR) versione 2.0 o successiva è attualmente caricato ed assemblyFile è stato compilato 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 CreateInstanceFrom metodo . Questo esempio di codice fa parte di un esempio più ampio fornito per la Activator classe .

// 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 ObjectHandle.Unwrap metodo per annullare il wrapping del valore restituito.

Per informazioni su altre eccezioni che possono essere generate dai metodi richiamati, vedere la sezione Eccezioni dei Assembly.LoadFrom metodi 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);

[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

Parametri

assemblyFile

String

Nome di un file che contiene 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 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 typeName costruttore. 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 typeName costruttore. 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 typeName costruttore. Se culture è null, viene utilizzato per CultureInfo 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 UrlAttribute oggetto 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.

Valori restituiti

ObjectHandle

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

Attributi

RequiresUnreferencedCodeAttribute

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 dell'oggetto richiesto FileIOPermission.

NotSupportedException

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

BadImageFormatException

assemblyFile non è un assembly valido.

oppure

Common Language Runtime (CLR) versione 2.0 o successiva è attualmente caricato ed assemblyFile è stato compilato 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 ObjectHandle.Unwrap metodo per annullare il wrapping del valore restituito.

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