Activator.CreateInstanceFrom Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego pliku zestawu i konstruktora, który najlepiej pasuje do określonych parametrów.

Przeciążenia

CreateInstanceFrom(String, String, Object[])	Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego pliku zestawu i konstruktora bez parametrów.
CreateInstanceFrom(String, String)	Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego pliku zestawu i konstruktora bez parametrów.
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego pliku zestawu i konstruktora, który najlepiej pasuje do określonych parametrów.

CreateInstanceFrom(String, String, Object[])

Źródło:

Activator.cs

Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego pliku zestawu i konstruktora bez parametrów.

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

Parametry

assemblyFile

String

Nazwa pliku zawierającego zestaw, w którym poszukiwany jest typ o nazwie typeName .

typeName

String

Nazwa typu do utworzenia wystąpienia.

activationAttributes

Object[]

Tablica jednego lub więcej atrybutów, które mogą brać udział w aktywacji. Jest to zazwyczaj tablica zawierająca pojedynczy UrlAttribute obiekt, który określa adres URL wymagany do aktywowania obiektu zdalnego.

Ten parametr jest powiązany z obiektami aktywowanymi przez klienta. Aktywacja klienta to starsza technologia, która jest zachowywana w celu zapewnienia zgodności z poprzednimi wersjami, ale nie jest zalecana w przypadku nowego programowania. Aplikacje rozproszone powinny zamiast tego używać programu Windows Communication Foundation.

Zwraca

ObjectHandle

Uchwyt, który musi być rozpasany, aby uzyskać dostęp do nowo utworzonego obiektu lub null na Nullable<T> przykład.

Wyjątki

ArgumentNullException

typeName to null.

MissingMethodException

Nie znaleziono pasującego publicznego konstruktora.

TypeLoadException

typename nie znaleziono w pliku assemblyFile.

FileNotFoundException

assemblyFile nie znaleziono.

MethodAccessException

Obiekt wywołujący nie ma uprawnień do wywoływania tego konstruktora.

MemberAccessException

Nie można utworzyć wystąpienia klasy abstrakcyjnej lub ten element członkowski został wywołany z mechanizmem późnego powiązania.

TargetInvocationException

Konstruktor, który został wywołany przez odbicie, rzucił wyjątek.

NotSupportedException

activationAttributes nie jest pustą tablicą, a tworzony typ nie pochodzi z MarshalByRefObjectklasy .

SecurityException

Obiekt wywołujący ma wymagany element FileIOPermission.

BadImageFormatException

assemblyFile nie jest prawidłowym zestawem.

-lub-

Środowisko uruchomieniowe języka wspólnego (CLR) w wersji 2.0 lub nowszej jest obecnie ładowane i assemblyName zostało skompilowane dla wersji środowiska CLR nowszej niż aktualnie załadowana wersja. Należy pamiętać, że .NET Framework w wersji 2.0, 3.0 i 3.5 używają środowiska CLR w wersji 2.0.

Uwagi

ObjectHandle.Unwrap Użyj metody , aby odpakować wartość zwracaną.

Aby uzyskać informacje o innych wyjątkach, które mogą być zgłaszane przez metody wywoływane, zobacz sekcję Assembly.LoadFrom Wyjątki metod i CreateInstance .

CreateInstanceFrom(String, String)

Źródło:

Activator.cs

Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego pliku zestawu i konstruktora bez parametrów.

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

Parametry

assemblyFile

String

Nazwa pliku zawierającego zestaw, w którym poszukiwany jest typ o nazwie typeName .

typeName

String

Nazwa typu do utworzenia wystąpienia.

Zwraca

ObjectHandle

Uchwyt, który musi być rozpasany, aby uzyskać dostęp do nowo utworzonego obiektu lub null na Nullable<T> przykład.

Wyjątki

ArgumentNullException

typeName to null.

MissingMethodException

Nie znaleziono pasującego publicznego konstruktora.

TypeLoadException

typename nie znaleziono w pliku assemblyFile.

FileNotFoundException

assemblyFile nie znaleziono.

MethodAccessException

Obiekt wywołujący nie ma uprawnień do wywoływania tego konstruktora.

MemberAccessException

Nie można utworzyć wystąpienia klasy abstrakcyjnej lub ten element członkowski został wywołany z mechanizmem późnego powiązania.

TargetInvocationException

Konstruktor, który został wywołany przez odbicie, rzucił wyjątek.

SecurityException

Obiekt wywołujący ma wymagany element FileIOPermission.

BadImageFormatException

assemblyFile nie jest prawidłowym zestawem.

-lub-

Środowisko uruchomieniowe języka wspólnego (CLR) w wersji 2.0 lub nowszej jest obecnie ładowane i assemblyName zostało skompilowane dla wersji środowiska CLR nowszej niż aktualnie załadowana wersja. Należy pamiętać, że .NET Framework w wersji 2.0, 3.0 i 3.5 używają środowiska CLR w wersji 2.0.

Przykłady

W poniższym przykładzie kodu pokazano, jak wywołać metodę CreateInstanceFrom . Ten przykład kodu jest częścią większego przykładu podanego Activator dla klasy.

// 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)

Uwagi

ObjectHandle.Unwrap Użyj metody , aby odpakować wartość zwracaną.

Aby uzyskać informacje o innych wyjątkach, które mogą być zgłaszane przez metody wywoływane, zobacz sekcję Assembly.LoadFrom Wyjątki metod i CreateInstance .

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

Źródło:

Activator.cs

Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego pliku zestawu i konstruktora, który najlepiej pasuje do określonych parametrów.

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

Parametry

assemblyFile

String

Nazwa pliku zawierającego zestaw, w którym poszukiwany jest typ o nazwie typeName .

typeName

String

Nazwa typu do utworzenia wystąpienia.

ignoreCase

Boolean

true aby określić, że wyszukiwanie typeName nie uwzględnia wielkości liter; false aby określić, że wyszukiwanie uwzględnia wielkość liter.

bindingAttr

BindingFlags

Kombinacja flag zero lub więcej bitów, które wpływają na wyszukiwanie konstruktora typeName . Jeśli bindingAttr wartość jest równa zero, przeprowadzane jest wyszukiwanie konstruktorów publicznych z uwzględnieniem wielkości liter.

binder

Binder

Obiekt, który używa bindingAttr elementu i args do wyszukiwania i identyfikowania konstruktora typeName . Jeśli binder parametr ma nullwartość , jest używany domyślny binder.

args

Object[]

Tablica argumentów, które są zgodne z liczbą, kolejnością i typem parametrów konstruktora do wywołania. Jeśli args jest pustą tablicą lub null, konstruktor, który nie przyjmuje żadnych parametrów (konstruktor bez parametrów) jest wywoływany.

culture

CultureInfo

Informacje specyficzne dla kultury, które regulują przymus do args typów formalnych zadeklarowanych dla konstruktora typeName . Jeśli culture parametr ma nullwartość , CultureInfo jest używany dla bieżącego wątku.

activationAttributes

Object[]

Tablica jednego lub więcej atrybutów, które mogą brać udział w aktywacji. Jest to zazwyczaj tablica zawierająca pojedynczy UrlAttribute obiekt, który określa adres URL wymagany do aktywowania obiektu zdalnego.

Ten parametr jest związany z obiektami aktywowanymi przez klienta. Aktywacja klienta to starsza technologia, która jest przechowywana w celu zapewnienia zgodności z poprzednimi wersjami, ale nie jest zalecana w przypadku nowego programowania. Aplikacje rozproszone powinny zamiast tego używać programu Windows Communication Foundation.

Zwraca

ObjectHandle

Uchwyt, który musi być niezapisany, aby uzyskać dostęp do nowo utworzonego obiektu lub null na Nullable<T> przykład.

Wyjątki

ArgumentNullException

typeName to null.

MissingMethodException

Nie znaleziono pasującego konstruktora.

TypeLoadException

typename nie znaleziono w pliku assemblyFile.

FileNotFoundException

assemblyFile nie znaleziono.

MethodAccessException

Obiekt wywołujący nie ma uprawnień do wywoływania tego konstruktora.

MemberAccessException

Nie można utworzyć wystąpienia klasy abstrakcyjnej lub ten element członkowski został wywołany z mechanizmem późnego powiązania.

TargetInvocationException

Konstruktor, który został wywołany przez odbicie, rzucił wyjątek.

SecurityException

Obiekt wywołujący nie ma wymaganego FileIOPermissionelementu .

NotSupportedException

activationAttributes nie jest pustą tablicą, a tworzony typ nie pochodzi z MarshalByRefObjectklasy .

BadImageFormatException

assemblyFile nie jest prawidłowym zestawem.

-lub-

Środowisko uruchomieniowe języka wspólnego (CLR) w wersji 2.0 lub nowszej jest obecnie ładowane i assemblyName zostało skompilowane dla wersji środowiska CLR nowszej niż aktualnie załadowana wersja. Należy pamiętać, że .NET Framework w wersji 2.0, 3.0 i 3.5 używają środowiska CLR w wersji 2.0.

Uwagi

ObjectHandle.Unwrap Użyj metody , aby odpakować wartość zwracaną.

Aby uzyskać informacje o innych wyjątkach, które mogą być zgłaszane przez wywoływane metody, zobacz sekcję Wyjątki metod Assembly.LoadFrom i CreateInstance .