Activator.CreateInstance Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Tworzy wystąpienie określonego typu przy użyciu konstruktora, który najlepiej pasuje do określonych parametrów.

Przeciążenia

CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego zestawu i konstruktora, który najlepiej pasuje do określonych parametrów.
CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo, Object[])	Tworzy wystąpienie określonego typu przy użyciu konstruktora, który najlepiej pasuje do określonych parametrów.
CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo)	Tworzy wystąpienie określonego typu przy użyciu konstruktora, który najlepiej pasuje do określonych parametrów.
CreateInstance(Type, Object[], Object[])	Tworzy wystąpienie określonego typu przy użyciu konstruktora, który najlepiej pasuje do określonych parametrów.
CreateInstance(String, String, Object[])	Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego zestawu i konstruktora bez parametrów.
CreateInstance(Type, Object[])	Tworzy wystąpienie określonego typu przy użyciu konstruktora, który najlepiej pasuje do określonych parametrów.
CreateInstance(Type, Boolean)	Tworzy wystąpienie określonego typu przy użyciu konstruktora bez parametrów tego typu.
CreateInstance(String, String)	Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego zestawu i konstruktora bez parametrów.
CreateInstance(Type)	Tworzy wystąpienie określonego typu przy użyciu konstruktora bez parametrów tego typu.
CreateInstance<T>()	Tworzy wystąpienie typu wyznaczonego przez określony parametr typu ogólnego przy użyciu konstruktora bez parametrów.

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

Źródło:

Activator.RuntimeType.cs

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

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

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

Public Shared Function CreateInstance (assemblyName 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

assemblyName

String

Nazwa zestawu, w którym poszukiwany jest typ o nazwie typeName. Jeśli assemblyName jest null, przeszukiwany jest wykonywany zestaw.

typeName

String

W pełni kwalifikowana nazwa typu do utworzenia wystąpienia.

ignoreCase

Boolean

true określić, że wyszukiwanie typeName nie uwzględnia wielkości liter; false 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 wynosi zero, przeprowadzane jest wyszukiwanie konstruktorów publicznych z uwzględnieniem wielkości liter.

binder

Binder

Obiekt, który używa bindingAttr i args do wyszukiwania i identyfikowania konstruktora typeName. Jeśli binder jest null, zostanie użyty domyślny binder.

args

Object[]

Tablica argumentów, które pasują do liczby, kolejności i wpisz parametry 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 określają przymus args do typów formalnych zadeklarowanych dla konstruktora typeName. Jeśli culture jest null, zostanie użyta CultureInfo dla bieżącego wątku.

activationAttributes

Object[]

Tablica co najmniej jednego atrybutu, który może uczestniczyć w aktywacji. Jest to zazwyczaj tablica zawierająca pojedynczy obiekt UrlAttribute, 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 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

Dojście, które musi być niezapisane, aby uzyskać dostęp do nowo utworzonego wystąpienia lub null dla wystąpień Nullable<T> bez wartości.

Wyjątki

ArgumentNullException

typeName jest null.

MissingMethodException

Nie znaleziono pasującego konstruktora.

TypeLoadException

nie można odnaleźć typeName w assemblyName.

FileNotFoundException

nie można odnaleźć assemblyName.

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.

InvalidComObjectException

Typ COM nie został uzyskany za pośrednictwem GetTypeFromProgID lub GetTypeFromCLSID.

NotSupportedException

Tworzenie typów TypedReference, ArgIterator, Voidi RuntimeArgumentHandle lub tablic tych typów nie jest obsługiwane.

-lub-

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

-lub-

Konstruktor, który najlepiej pasuje do args, ma varargs argumenty.

BadImageFormatException

assemblyName nie jest prawidłowym zestawem.

-lub-

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

FileLoadException

Zestaw lub moduł został załadowany dwukrotnie z dwoma różnymi dowodami.

-lub-

Nazwa zestawu lub baza kodu jest nieprawidłowa.

Uwagi

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

Nuta

Począwszy od programu .NET Framework 2.0, ta metoda może służyć do tworzenia typów niepublikacyjnych i elementów członkowskich, jeśli obiekt wywołujący otrzymał ReflectionPermission z flagą ReflectionPermissionFlag.RestrictedMemberAccess i jeśli zestaw dotacji zestawu, który zawiera typy niepublicowe i elementy członkowskie, jest ograniczony do zestawu dotacji obiektu wywołującego lub do jego podzbioru. (Zobacz zagadnienia dotyczące zabezpieczeń dotyczące odbicia). Aby korzystać z tej funkcji, aplikacja powinna być docelowa dla programu .NET Framework 3.5 lub nowszego.

CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo, Object[])

Źródło:

Activator.RuntimeType.cs

Tworzy wystąpienie określonego typu przy użyciu konstruktora, który najlepiej pasuje do określonych parametrów.

public:
 static System::Object ^ CreateInstance(Type ^ type, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture, cli::array <System::Object ^> ^ activationAttributes);

public static object? CreateInstance (Type type, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);

static member CreateInstance : Type * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> obj

Public Shared Function CreateInstance (type As Type, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object()) As Object

Parametry

type

Type

Typ obiektu do utworzenia.

bindingAttr

BindingFlags

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

binder

Binder

Obiekt, który używa bindingAttr i args do wyszukiwania i identyfikowania konstruktora type. Jeśli binder jest null, zostanie użyty domyślny binder.

args

Object[]

Tablica argumentów, które pasują do liczby, kolejności i wpisz parametry 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 określają przymus args do typów formalnych zadeklarowanych dla konstruktora type. Jeśli culture jest null, zostanie użyta CultureInfo dla bieżącego wątku.

activationAttributes

Object[]

Tablica co najmniej jednego atrybutu, który może uczestniczyć w aktywacji. Jest to zazwyczaj tablica zawierająca pojedynczy obiekt UrlAttribute, 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 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

Object

Odwołanie do nowo utworzonego obiektu lub null dla wystąpień Nullable<T> bez wartości.

Wyjątki

ArgumentNullException

type jest null.

ArgumentException

type nie jest RuntimeType.

-lub-

type jest otwartym typem ogólnym (czyli właściwość ContainsGenericParameters zwraca wartość true).

NotSupportedException

type nie może być TypeBuilder.

-lub-

Tworzenie typów TypedReference, ArgIterator, Voidi RuntimeArgumentHandle lub tablic tych typów nie jest obsługiwane.

-lub-

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

-lub-

Zestaw zawierający type jest zestawem dynamicznym utworzonym za pomocą Save.

-lub-

Konstruktor, który najlepiej pasuje do args, ma varargs argumenty.

TargetInvocationException

Wywoływany konstruktor zgłasza wyjątek.

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.

InvalidComObjectException

Typ COM nie został uzyskany za pośrednictwem GetTypeFromProgID lub GetTypeFromCLSID.

MissingMethodException

Nie znaleziono pasującego konstruktora.

COMException

type jest obiektem COM, ale identyfikator klasy używany do uzyskania typu jest nieprawidłowy lub zidentyfikowana klasa nie jest zarejestrowana.

TypeLoadException

type nie jest prawidłowym typem.

Uwagi

Konstruktor, który ma być wywoływany, musi zapewnić najbardziej specyficzne dopasowanie z określoną listą argumentów w ramach ograniczeń określonych atrybutów binder i powiązania.

Nuta

Począwszy od programu .NET Framework 2.0, ta metoda może służyć do uzyskiwania dostępu do typów niepublikacyjnych i elementów członkowskich, jeśli obiekt wywołujący otrzymał ReflectionPermission z flagą ReflectionPermissionFlag.RestrictedMemberAccess i jeśli zestaw dotacji typów niepublicowych i elementów członkowskich jest ograniczony do zestawu dotacji obiektu wywołującego lub do jego podzbioru. (Zobacz zagadnienia dotyczące zabezpieczeń dotyczące odbicia). Aby korzystać z tej funkcji, aplikacja powinna być docelowa dla programu .NET Framework 3.5 lub nowszego.

CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo)

Źródło:

Activator.cs

Tworzy wystąpienie określonego typu przy użyciu konstruktora, który najlepiej pasuje do określonych parametrów.

public:
 static System::Object ^ CreateInstance(Type ^ type, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture);

public static object? CreateInstance (Type type, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture);

static member CreateInstance : Type * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo -> obj

Public Shared Function CreateInstance (type As Type, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo) As Object

Parametry

type

Type

Typ obiektu do utworzenia.

bindingAttr

BindingFlags

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

binder

Binder

Obiekt, który używa bindingAttr i args do wyszukiwania i identyfikowania konstruktora type. Jeśli binder jest null, zostanie użyty domyślny binder.

args

Object[]

Tablica argumentów, które pasują do liczby, kolejności i wpisz parametry 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 określają przymus args do typów formalnych zadeklarowanych dla konstruktora type. Jeśli culture jest null, zostanie użyta CultureInfo dla bieżącego wątku.

Zwraca

Object

Odwołanie do nowo utworzonego obiektu lub null dla wystąpień Nullable<T> bez wartości.

Wyjątki

ArgumentNullException

type jest null.

ArgumentException

type nie jest RuntimeType.

-lub-

type jest otwartym typem ogólnym (czyli właściwość ContainsGenericParameters zwraca wartość true).

NotSupportedException

type nie może być TypeBuilder.

-lub-

Tworzenie typów TypedReference, ArgIterator, Voidi RuntimeArgumentHandle lub tablic tych typów nie jest obsługiwane.

-lub-

Zestaw zawierający type jest zestawem dynamicznym utworzonym za pomocą Save.

-lub-

Konstruktor, który najlepiej pasuje do args, ma varargs argumenty.

TargetInvocationException

Wywoływany konstruktor zgłasza wyjątek.

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.

InvalidComObjectException

Typ COM nie został uzyskany za pośrednictwem GetTypeFromProgID lub GetTypeFromCLSID.

MissingMethodException

Nie znaleziono pasującego konstruktora.

COMException

type jest obiektem COM, ale identyfikator klasy używany do uzyskania typu jest nieprawidłowy lub zidentyfikowana klasa nie jest zarejestrowana.

TypeLoadException

type nie jest prawidłowym typem.

Uwagi

Konstruktor, który ma być wywoływany, musi zapewnić najbardziej specyficzne dopasowanie z określoną listą argumentów w ramach ograniczeń określonych atrybutów binder i powiązania.

Nuta

Począwszy od programu .NET Framework 2.0, ta metoda może służyć do uzyskiwania dostępu do typów niepublikacyjnych i elementów członkowskich, jeśli obiekt wywołujący otrzymał ReflectionPermission z flagą ReflectionPermissionFlag.RestrictedMemberAccess i jeśli zestaw dotacji zawierający typy niepublic i elementy członkowskie są ograniczone do zestawu dotacji obiektu wywołującego lub do jego podzbioru. (Zobacz zagadnienia dotyczące zabezpieczeń dotyczące odbicia). Aby korzystać z tej funkcji, aplikacja powinna być docelowa dla programu .NET Framework 3.5 lub nowszego.

CreateInstance(Type, Object[], Object[])

Źródło:

Activator.cs

Tworzy wystąpienie określonego typu przy użyciu konstruktora, który najlepiej pasuje do określonych parametrów.

public:
 static System::Object ^ CreateInstance(Type ^ type, cli::array <System::Object ^> ^ args, cli::array <System::Object ^> ^ activationAttributes);

public static object? CreateInstance (Type type, object?[]? args, object?[]? activationAttributes);

static member CreateInstance : Type * obj[] * obj[] -> obj

Public Shared Function CreateInstance (type As Type, args As Object(), activationAttributes As Object()) As Object

Parametry

type

Type

Typ obiektu do utworzenia.

args

Object[]

Tablica argumentów, które pasują do liczby, kolejności i wpisz parametry 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.

activationAttributes

Object[]

Tablica co najmniej jednego atrybutu, który może uczestniczyć w aktywacji. Jest to zazwyczaj tablica zawierająca pojedynczy obiekt UrlAttribute, 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 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

Object

Odwołanie do nowo utworzonego obiektu lub null dla wystąpień Nullable<T> bez wartości.

Wyjątki

ArgumentNullException

type jest null.

ArgumentException

type nie jest RuntimeType.

-lub-

type jest otwartym typem ogólnym (czyli właściwość ContainsGenericParameters zwraca wartość true).

NotSupportedException

type nie może być TypeBuilder.

-lub-

Tworzenie typów TypedReference, ArgIterator, Voidi RuntimeArgumentHandle lub tablic tych typów nie jest obsługiwane.

-lub-

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

-lub-

Zestaw zawierający type jest zestawem dynamicznym utworzonym za pomocą Save.

-lub-

Konstruktor, który najlepiej pasuje do args, ma varargs argumenty.

TargetInvocationException

Wywoływany konstruktor zgłasza wyjątek.

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.

InvalidComObjectException

Typ COM nie został uzyskany za pośrednictwem GetTypeFromProgID lub GetTypeFromCLSID.

MissingMethodException

Nie znaleziono pasującego publicznego konstruktora.

COMException

type jest obiektem COM, ale identyfikator klasy używany do uzyskania typu jest nieprawidłowy lub zidentyfikowana klasa nie jest zarejestrowana.

TypeLoadException

type nie jest prawidłowym typem.

Uwagi

Konstruktor, który ma być wywoływany, musi być dostępny i musi zapewnić najbardziej specyficzne dopasowanie z określoną listą argumentów.

Nuta

Począwszy od programu .NET Framework 2.0, ta metoda może służyć do uzyskiwania dostępu do typów niepublikacyjnych, jeśli obiekt wywołujący otrzymał ReflectionPermission z flagą ReflectionPermissionFlag.RestrictedMemberAccess, a jeśli zestaw dotacji zawierający typy niepublicowe jest ograniczony do zestawu dotacji obiektu wywołującego lub do jego podzbioru. (Zobacz zagadnienia dotyczące zabezpieczeń dotyczące odbicia). Aby korzystać z tej funkcji, aplikacja powinna być docelowa dla programu .NET Framework 3.5 lub nowszego.

CreateInstance(String, String, Object[])

Źródło:

Activator.RuntimeType.cs

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

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

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

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

Public Shared Function CreateInstance (assemblyName As String, typeName As String, activationAttributes As Object()) As ObjectHandle

Parametry

assemblyName

String

Nazwa zestawu, w którym poszukiwany jest typ o nazwie typeName. Jeśli assemblyName jest null, przeszukiwany jest wykonywany zestaw.

typeName

String

W pełni kwalifikowana nazwa typu do utworzenia wystąpienia.

activationAttributes

Object[]

Tablica co najmniej jednego atrybutu, który może uczestniczyć w aktywacji. Jest to zazwyczaj tablica zawierająca pojedynczy obiekt UrlAttribute, 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 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 zostać rozpasany, aby uzyskać dostęp do nowo utworzonego obiektu lub null dla wystąpień Nullable<T>.

Wyjątki

ArgumentNullException

typeName jest null.

MissingMethodException

Nie znaleziono pasującego publicznego konstruktora.

TypeLoadException

nie można odnaleźć typeName w assemblyName.

FileNotFoundException

nie można odnaleźć assemblyName.

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.

InvalidComObjectException

Typ COM nie został uzyskany za pośrednictwem GetTypeFromProgID lub GetTypeFromCLSID.

NotSupportedException

Tworzenie typów TypedReference, ArgIterator, Voidi RuntimeArgumentHandle lub tablic tych typów nie jest obsługiwane.

-lub-

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

-lub-

activationAttributes nie jest UrlAttribute

tablica.

BadImageFormatException

assemblyName nie jest prawidłowym zestawem.

-lub-

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

FileLoadException

Zestaw lub moduł został załadowany dwukrotnie z dwoma różnymi dowodami.

-lub-

Nazwa zestawu lub baza kodu jest nieprawidłowa.

TargetInvocationException

Wywoływany konstruktor zgłasza wyjątek.

-lub-

Wystąpił błąd podczas próby aktywacji zdalnej w obiekcie docelowym określonym w activationAttributes.

Uwagi

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

Nuta

Począwszy od programu .NET Framework 2.0, ta metoda może służyć do tworzenia typów niepublikacyjnych, jeśli obiekt wywołujący otrzymał ReflectionPermission z flagą ReflectionPermissionFlag.RestrictedMemberAccess i jeśli zestaw dotacji typów niepublikacyjnych jest ograniczony do zestawu dotacji obiektu wywołującego lub do jego podzbioru. (Zobacz zagadnienia dotyczące zabezpieczeń dotyczące odbicia). Aby korzystać z tej funkcji, aplikacja powinna być docelowa dla programu .NET Framework 3.5 lub nowszego.

CreateInstance(Type, Object[])

Źródło:

Activator.cs

Tworzy wystąpienie określonego typu przy użyciu konstruktora, który najlepiej pasuje do określonych parametrów.

public:
 static System::Object ^ CreateInstance(Type ^ type, ... cli::array <System::Object ^> ^ args);

public static object? CreateInstance (Type type, params object?[]? args);

static member CreateInstance : Type * obj[] -> obj

Public Shared Function CreateInstance (type As Type, ParamArray args As Object()) As Object

Parametry

type

Type

Typ obiektu do utworzenia.

args

Object[]

Tablica argumentów, które pasują do liczby, kolejności i wpisz parametry 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.

Zwraca

Object

Odwołanie do nowo utworzonego obiektu lub null dla wystąpień Nullable<T> bez wartości.

Wyjątki

ArgumentNullException

type jest null.

ArgumentException

type nie jest RuntimeType.

-lub-

type jest otwartym typem ogólnym (czyli właściwość ContainsGenericParameters zwraca wartość true).

NotSupportedException

type nie może być TypeBuilder.

-lub-

Tworzenie typów TypedReference, ArgIterator, Voidi RuntimeArgumentHandle lub tablic tych typów nie jest obsługiwane.

-lub-

Zestaw zawierający type jest zestawem dynamicznym utworzonym za pomocą Save.

-lub-

Konstruktor, który najlepiej pasuje do args, ma varargs argumenty.

TargetInvocationException

Wywoływany konstruktor zgłasza wyjątek.

MethodAccessException

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

Uwaga: w .NET dla aplikacji ze Sklepu Windows lub przenośnej biblioteki klasprzechwyć wyjątek klasy bazowej, MemberAccessException, zamiast tego.

MemberAccessException

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

InvalidComObjectException

Typ COM nie został uzyskany za pośrednictwem GetTypeFromProgID lub GetTypeFromCLSID.

MissingMethodException

Nie znaleziono pasującego publicznego konstruktora.

Uwaga: w .NET dla aplikacji ze Sklepu Windows lub przenośnej biblioteki klasprzechwyć wyjątek klasy bazowej, MissingMemberException, zamiast tego.

COMException

type jest obiektem COM, ale identyfikator klasy używany do uzyskania typu jest nieprawidłowy lub zidentyfikowana klasa nie jest zarejestrowana.

TypeLoadException

type nie jest prawidłowym typem.

Przykłady

Poniższy przykład wywołuje metodę CreateInstance(Type, Object[]) w celu utworzenia obiektu String. Wywołuje konstruktor String.String(Char[], Int32, Int32), aby utworzyć wystąpienie ciągu zawierającego dziesięć elementów z tablicy znaków rozpoczynającej się od czternastej pozycji.

using System;

public class Example
{
   public static void Main()
   {
      // Initialize array of characters from a to z.
      char[] chars = new char[26];
      for (int ctr = 0; ctr < 26; ctr++)
         chars[ctr] = (char) (ctr + 0x0061);

      object obj = Activator.CreateInstance(typeof(string),
                                            new object[] { chars, 13, 10 } );
      Console.WriteLine(obj);
   }
}
// The example displays the following output:
//       nopqrstuvw

open System

// Initialize array of characters from a to z.
let chars = [| 'a' .. 'z' |]

let obj = Activator.CreateInstance(typeof<string>, chars[13..22])

printfn $"{obj}"

// The example displays the following output:
//       nopqrstuvw

Module Example
   Public Sub Main()
      ' Initialize array of characters from a to z.
      Dim chars(25) As Char 
      For ctr As Short = 0 To 25
         chars(ctr) = ChrW(ctr + &h0061)
      Next 
      Dim obj As Object = Activator.CreateInstance(GetType(String),
                                                   { chars, 13, 10 })
      Console.WriteLine(obj)                                          
   End Sub
End Module
' The example displays the following output:
'       nopqrstuvw

W poniższym przykładzie jest tworzona tablica postrzępiona, której elementy są argumentami, które mają zostać przekazane do konstruktora String. W tym przykładzie każda tablica jest następnie przekazywana do metody CreateInstance(Type, Object[]) w celu wywołania odpowiedniego konstruktora ciągu.

using System;

public class Example
{
   public static void Main()
   {
      char[] characters = { 'a', 'b', 'c', 'd', 'e', 'f' };
      object[][] arguments = new object[3][] { new object[] { characters },
                                               new object[] { characters, 1, 4 },
                                               new object[] { characters[1], 20 } };

      for (int ctr = 0; ctr <= arguments.GetUpperBound(0); ctr++) {
         object[] args = arguments[ctr];
         object result = Activator.CreateInstance(typeof(string), args);
         Console.WriteLine("{0}: {1}", result.GetType().Name, result);
      }
   }
}
// The example displays the following output:
//    String: abcdef
//    String: bcde
//    String: bbbbbbbbbbbbbbbbbbbb

open System

let chars = [| 'a' .. 'f' |]

let arguments =
    [| chars
       chars[1..4]
       Array.create 20 chars[1] |]

for args in arguments do
    let result =
        Activator.CreateInstance(typeof<string>, args)

    printfn $"{result.GetType().Name}: {result}"

// The example displays the following output:
//    String: abcdef
//    String: bcde
//    String: bbbbbbbbbbbbbbbbbbbb

Module Example
   Public Sub Main()
      Dim characters() As Char = { "a"c, "b"c, "c"c, "d"c, "e"c, "f"c }
      Dim arguments()() As Object = new Object(2)() { New Object() { characters },
                                                      New Object() { characters, 1, 4 },
                                                      New Object() { characters(1), 20 } }

      For ctr As Integer = 0 To arguments.GetUpperBound(0)
         Dim args() As Object = arguments(ctr)
         Dim result As Object = Activator.CreateInstance(GetType(String), args)
         Console.WriteLine("{0}: {1}", result.GetType().Name, result)
      Next
   End Sub
End Module
' The example displays the following output:
'       String: abcdef
'       String: bcde
'       String: bbbbbbbbbbbbbbbbbbbb

Uwagi

Konstruktor, który ma być wywoływany, musi być dostępny i musi zapewnić najbardziej specyficzne dopasowanie z określoną listą argumentów.

Nuta

Począwszy od programu .NET Framework 2.0, ta metoda może służyć do uzyskiwania dostępu do typów niepublikacyjnych, jeśli obiekt wywołujący otrzymał ReflectionPermission z flagą ReflectionPermissionFlag.RestrictedMemberAccess, a jeśli zestaw dotacji zawierający typy niepublicowe jest ograniczony do zestawu dotacji obiektu wywołującego lub do jego podzbioru. (Zobacz zagadnienia dotyczące zabezpieczeń dotyczące odbicia). Aby korzystać z tej funkcji, aplikacja powinna być docelowa dla programu .NET Framework 3.5 lub nowszego.

CreateInstance(Type, Boolean)

Źródło:

Activator.RuntimeType.cs

Tworzy wystąpienie określonego typu przy użyciu konstruktora bez parametrów tego typu.

public:
 static System::Object ^ CreateInstance(Type ^ type, bool nonPublic);

public static object? CreateInstance (Type type, bool nonPublic);

static member CreateInstance : Type * bool -> obj

Public Shared Function CreateInstance (type As Type, nonPublic As Boolean) As Object

Parametry

type

Type

Typ obiektu do utworzenia.

nonPublic

Boolean

true, jeśli publiczny lub niepublikowy konstruktor bez parametrów może być zgodny; false, jeśli tylko publiczny konstruktor bez parametrów może być zgodny.

Zwraca

Object

Odwołanie do nowo utworzonego obiektu lub null dla wystąpień Nullable<T>.

Wyjątki

ArgumentNullException

type jest null.

ArgumentException

type nie jest RuntimeType.

-lub-

type jest otwartym typem ogólnym (czyli właściwość ContainsGenericParameters zwraca wartość true).

NotSupportedException

type nie może być TypeBuilder.

-lub-

Tworzenie typów TypedReference, ArgIterator, Voidi RuntimeArgumentHandle lub tablic tych typów nie jest obsługiwane.

-lub-

Zestaw zawierający type jest zestawem dynamicznym utworzonym za pomocą Save.

TargetInvocationException

Wywoływany konstruktor zgłasza wyjątek.

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.

InvalidComObjectException

Typ COM nie został uzyskany za pośrednictwem GetTypeFromProgID lub GetTypeFromCLSID.

MissingMethodException

Nie znaleziono pasującego publicznego konstruktora.

COMException

type jest obiektem COM, ale identyfikator klasy używany do uzyskania typu jest nieprawidłowy lub zidentyfikowana klasa nie jest zarejestrowana.

TypeLoadException

type nie jest prawidłowym typem.

Uwagi

Nuta

Począwszy od programu .NET Framework 2.0, ta metoda może służyć do uzyskiwania dostępu do typów niepublikacyjnych i elementów członkowskich, jeśli obiekt wywołujący otrzymał ReflectionPermission z flagą ReflectionPermissionFlag.RestrictedMemberAccess i jeśli zestaw dotacji zawierający typy niepublic i elementy członkowskie są ograniczone do zestawu dotacji obiektu wywołującego lub do jego podzbioru. (Zobacz zagadnienia dotyczące zabezpieczeń dotyczące odbicia). Aby korzystać z tej funkcji, aplikacja powinna być docelowa dla programu .NET Framework 3.5 lub nowszego.

CreateInstance(String, String)

Źródło:

Activator.RuntimeType.cs

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

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName);

public static System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName);

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

Public Shared Function CreateInstance (assemblyName As String, typeName As String) As ObjectHandle

Parametry

assemblyName

String

Nazwa zestawu, w którym poszukiwany jest typ o nazwie typeName. Jeśli assemblyName jest null, przeszukiwany jest wykonywany zestaw.

typeName

String

W pełni kwalifikowana nazwa typu do utworzenia wystąpienia.

Zwraca

ObjectHandle

Uchwyt, który musi zostać rozpasany, aby uzyskać dostęp do nowo utworzonego obiektu lub null dla wystąpień Nullable<T>.

Wyjątki

ArgumentNullException

typeName jest null.

MissingMethodException

Nie znaleziono pasującego publicznego konstruktora.

TypeLoadException

nie można odnaleźć typeName w assemblyName.

FileNotFoundException

nie można odnaleźć assemblyName.

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.

InvalidComObjectException

Typ COM nie został uzyskany za pośrednictwem GetTypeFromProgID lub GetTypeFromCLSID.

NotSupportedException

Tworzenie typów TypedReference, ArgIterator, Voidi RuntimeArgumentHandle lub tablic tych typów nie jest obsługiwane.

BadImageFormatException

assemblyName nie jest prawidłowym zestawem.

-lub-

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

FileLoadException

Zestaw lub moduł został załadowany dwukrotnie z dwoma różnymi dowodami.

-lub-

Nazwa zestawu lub baza kodu jest nieprawidłowa.

Przykłady

W poniższym przykładzie zdefiniowano klasę o nazwie Person w zestawie o nazwie PersonInfo. Należy pamiętać, że klasa Person ma dwa konstruktory, z których jeden jest bez parametrów.

using System;

public class Person
{
   private string _name;

   public Person()
   { }

   public Person(string name)
   {
      this._name = name;
   }

   public string Name
   { get { return this._name; }
     set { this._name = value; } }

   public override string ToString()
   {
      return this._name;
   }
}

type Person(name) =
    member val Name = name with get, set

    override this.ToString() = this.Name

    new () = Person Unchecked.defaultof<string>

Public Class Person
   Private _name As String
   
   Public Sub New()
   End Sub
   
   Public Sub New(name As String)
      Me._name = name
   End Sub
   
   Public Property Name As String
      Get
         Return Me._name
      End Get
      Set
         Me._name = value
      End Set
   End Property
   
   Public Overrides Function ToString() As String
      Return Me._name
   End Function
End Class

Poniższy przykład wywołuje metodę CreateInstance(String, String) w celu utworzenia wystąpienia klasy Person. Wymaga to odwołania do PersonInfo.dll, które mają zostać dodane do projektu. Ponieważ metoda CreateInstance(String, String) wywołuje konstruktor bez parametrów klasy Person, przykład przypisuje wartość do jej właściwości Name.

using System;
using System.Runtime.Remoting;

public class Example
{
   public static void Main()
   {
      ObjectHandle handle = Activator.CreateInstance("PersonInfo", "Person");
      Person p = (Person) handle.Unwrap();
      p.Name = "Samuel";
      Console.WriteLine(p);
   }
}
// The example displays the following output:
//        Samuel

open System

let handle = Activator.CreateInstance("PersonInfo", "Person")
let p = handle.Unwrap() :?> Person
p.Name <- "Samuel"
printfn $"{p}"

// The example displays the following output:
//        Samuel

Imports System.Runtime.Remoting

Module Example
   Public Sub Main()
      Dim handle As ObjectHandle = Activator.CreateInstance("PersonInfo", "Person")
      Dim p As Person = CType(handle.Unwrap(), Person)
      p.Name = "Samuel"
      Console.WriteLine(p)
   End Sub
End Module
' The example displays the following output:
'       Samuel

Jednak CreateInstance jest często wywoływana w celu utworzenia wystąpienia typu, który przekracza granice maszyny lub który nie jest znany w czasie projektowania. W takim przypadku nie można dołączyć odwołania do zestawu w projekcie i nie można wykonać wywołań z wczesnym powiązaniem z elementami członkowskimi typu. Aby obejść to ograniczenie, w poniższym przykładzie użyto metody CreateInstance wraz z odbiciem, aby przypisać wartość do właściwości Name obiektu Person i wyświetlić jego wartość.

using System;
using System.Reflection;
using System.Runtime.Remoting;

public class Example
{
   public static void Main()
   {
      ObjectHandle handle = Activator.CreateInstance("PersonInfo", "Person");
      object p = handle.Unwrap();
      Type t = p.GetType();
      PropertyInfo prop = t.GetProperty("Name");
      if (prop != null)
         prop.SetValue(p, "Samuel");

      MethodInfo method = t.GetMethod("ToString");
      object retVal = method.Invoke(p, null);
      if (retVal != null)
         Console.WriteLine(retVal);
   }
}
// The example displays the following output:
//        Samuel

open System

let handle =
    Activator.CreateInstance("PersonInfo", "Person")

let p = handle.Unwrap()
let t = p.GetType()
let prop = t.GetProperty "Name"

if not (isNull prop) then
    prop.SetValue(p, "Samuel")

let method = t.GetMethod "ToString"
let retVal = method.Invoke(p, null)

if not (isNull retVal) then
    printfn $"{retVal}"

// The example displays the following output:
//        Samuel

Imports System.Reflection
Imports System.Runtime.Remoting

Module Example
   Public Sub Main()
      Dim handle As ObjectHandle = Activator.CreateInstance("PersonInfo", "Person")
      Dim p As Object = handle.Unwrap()
      Dim t As Type = p.GetType()
      Dim prop As PropertyInfo = t.GetProperty("Name")
      if Not prop Is Nothing Then
         prop.SetValue(p, "Samuel")
      End If   
      Dim method As MethodInfo = t.GetMethod("ToString")
      Dim retVal As Object = method.Invoke(p, Nothing) 
      If Not retVal Is Nothing Then
         Console.WriteLine(retVal)
      End If
   End Sub
End Module
' The example displays the following output:
'       Samuel

Uwagi

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

assemblyName mogą być następujące:

• Prosta nazwa zestawu bez jego ścieżki lub rozszerzenia pliku. Można na przykład określić TypeExtensions dla zestawu, którego ścieżka i nazwa to .\bin\TypeExtensions.dll.

• Pełna nazwa podpisanego zestawu, który składa się z prostej nazwy, wersji, kultury i tokenu klucza publicznego; na przykład "TypeExtensions, Version=1.0.0.0, Culture=neutral, PublicKeyToken=181869f2f7435b51".

Aby uzyskać więcej informacji na temat sposobu identyfikowania i ładowania zestawów w środowisku uruchomieniowym języka wspólnego, zobacz Jak środowisko uruchomieniowe lokalizuje zestawy. Aby uzyskać informacje na temat używania pliku konfiguracji aplikacji do definiowania lokalizacji zestawów, zobacz Określanie lokalizacji zestawu. Jeśli assemblyName zostanie znaleziony, zostanie załadowany w kontekście domyślnym.

Nuta

Począwszy od programu .NET Framework 2.0, ta metoda może służyć do tworzenia typów niepublikacyjnych, jeśli obiekt wywołujący otrzymał ReflectionPermission z flagą ReflectionPermissionFlag.RestrictedMemberAccess i jeśli zestaw dotacji zawierający typy niepublicowe jest ograniczony do zestawu dotacji obiektu wywołującego lub do jego podzbioru. (Zobacz zagadnienia dotyczące zabezpieczeń dotyczące odbicia). Aby korzystać z tej funkcji, aplikacja powinna być docelowa dla programu .NET Framework 3.5 lub nowszego.

CreateInstance(Type)

Źródło:

Activator.cs

Tworzy wystąpienie określonego typu przy użyciu konstruktora bez parametrów tego typu.

public:
 static System::Object ^ CreateInstance(Type ^ type);

public static object? CreateInstance (Type type);

static member CreateInstance : Type -> obj

Public Shared Function CreateInstance (type As Type) As Object

Parametry

type

Type

Typ obiektu do utworzenia.

Zwraca

Object

Odwołanie do nowo utworzonego obiektu lub null dla wystąpień Nullable<T>.

Wyjątki

ArgumentNullException

type jest null.

ArgumentException

type nie jest RuntimeType.

-lub-

type jest otwartym typem ogólnym (czyli właściwość ContainsGenericParameters zwraca wartość true).

NotSupportedException

type nie może być TypeBuilder.

-lub-

Tworzenie typów TypedReference, ArgIterator, Voidi RuntimeArgumentHandle lub tablic tych typów nie jest obsługiwane.

-lub-

Zestaw zawierający type jest zestawem dynamicznym utworzonym za pomocą Save.

TargetInvocationException

Wywoływany konstruktor zgłasza wyjątek.

MethodAccessException

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

Uwaga: w .NET dla aplikacji ze Sklepu Windows lub przenośnej biblioteki klasprzechwyć wyjątek klasy bazowej, MemberAccessException, zamiast tego.

MemberAccessException

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

InvalidComObjectException

Typ COM nie został uzyskany za pośrednictwem GetTypeFromProgID lub GetTypeFromCLSID.

MissingMethodException

Nie znaleziono pasującego publicznego konstruktora.

Uwaga: w .NET dla aplikacji ze Sklepu Windows lub przenośnej biblioteki klasprzechwyć wyjątek klasy bazowej, MissingMemberException, zamiast tego.

COMException

type jest obiektem COM, ale identyfikator klasy używany do uzyskania typu jest nieprawidłowy lub zidentyfikowana klasa nie jest zarejestrowana.

TypeLoadException

type nie jest prawidłowym typem.

Przykłady

W poniższym przykładzie kodu pokazano, jak wywołać metodę CreateInstance(Type). Tworzone są wystąpienia kilku różnych typów, a ich wartości domyślne są wyświetlane.

using namespace System;

ref class DynamicInstanceList
{
private:
    static String^ instanceSpec = "System.EventArgs;System.Random;" +
        "System.Exception;System.Object;System.Version";

public:
    static void Main()
    {
        array<String^>^ instances = instanceSpec->Split(';');
        Array^ instlist = Array::CreateInstance(Object::typeid, instances->Length);
        Object^ item;

        for (int i = 0; i < instances->Length; i++)
        {
            // create the object from the specification string
            Console::WriteLine("Creating instance of: {0}", instances[i]);
            item = Activator::CreateInstance(Type::GetType(instances[i]));
            instlist->SetValue(item, i);
        }
        Console::WriteLine("\nObjects and their default values:\n");
        for each (Object^ o in instlist)
        {
            Console::WriteLine("Type:     {0}\nValue:    {1}\nHashCode: {2}\n",
                o->GetType()->FullName, o->ToString(), o->GetHashCode());
        }
    }
};

int main()
{
    DynamicInstanceList::Main();
}

// This program will display output similar to the following:
//
// Creating instance of: System.EventArgs
// Creating instance of: System.Random
// Creating instance of: System.Exception
// Creating instance of: System.Object
// Creating instance of: System.Version
//
// Objects and their default values:
//
// Type:     System.EventArgs
// Value:    System.EventArgs
// HashCode: 46104728
//
// Type:     System.Random
// Value:    System.Random
// HashCode: 12289376
//
// Type:     System.Exception
// Value:    System.Exception: Exception of type 'System.Exception' was thrown.
// HashCode: 55530882
//
// Type:     System.Object
// Value:    System.Object
// HashCode: 30015890
//
// Type:     System.Version
// Value:    0.0
// HashCode: 1048575

using System;

class DynamicInstanceList
{
    private static string instanceSpec = "System.EventArgs;System.Random;" +
        "System.Exception;System.Object;System.Version";

    public static void Main()
    {
        string[] instances = instanceSpec.Split(';');
        Array instlist = Array.CreateInstance(typeof(object), instances.Length);
        object item;
        for (int i = 0; i < instances.Length; i++)
        {
            // create the object from the specification string
            Console.WriteLine("Creating instance of: {0}", instances[i]);
            item = Activator.CreateInstance(Type.GetType(instances[i]));
            instlist.SetValue(item, i);
        }
        Console.WriteLine("\nObjects and their default values:\n");
        foreach (object o in instlist)
        {
            Console.WriteLine("Type:     {0}\nValue:    {1}\nHashCode: {2}\n",
                o.GetType().FullName, o.ToString(), o.GetHashCode());
        }
    }
}

// This program will display output similar to the following:
//
// Creating instance of: System.EventArgs
// Creating instance of: System.Random
// Creating instance of: System.Exception
// Creating instance of: System.Object
// Creating instance of: System.Version
//
// Objects and their default values:
//
// Type:     System.EventArgs
// Value:    System.EventArgs
// HashCode: 46104728
//
// Type:     System.Random
// Value:    System.Random
// HashCode: 12289376
//
// Type:     System.Exception
// Value:    System.Exception: Exception of type 'System.Exception' was thrown.
// HashCode: 55530882
//
// Type:     System.Object
// Value:    System.Object
// HashCode: 30015890
//
// Type:     System.Version
// Value:    0.0
// HashCode: 1048575

open System

let instanceSpec =
    "System.EventArgs;System.Random;System.Exception;System.Object;System.Version"

let instances = instanceSpec.Split ';'
let instlist = Array.zeroCreate instances.Length
let mutable item = obj ()

for i = 0 to instances.Length - 1 do
    // create the object from the specification string
    printfn $"Creating instance of: {instances.[i]}"
    item <- Activator.CreateInstance(Type.GetType instances.[i])
    instlist.[i] <- item

printfn "\nObjects and their default values:\n"

for o in instlist do
    printfn $"Type:     {o.GetType().FullName}\nValue:    {o}\nHashCode: {o.GetHashCode()}\n"


// This program will display output similar to the following:
//
// Creating instance of: System.EventArgs
// Creating instance of: System.Random
// Creating instance of: System.Exception
// Creating instance of: System.Object
// Creating instance of: System.Version
//
// Objects and their default values:
//
// Type:     System.EventArgs
// Value:    System.EventArgs
// HashCode: 46104728
//
// Type:     System.Random
// Value:    System.Random
// HashCode: 12289376
//
// Type:     System.Exception
// Value:    System.Exception: Exception of type 'System.Exception' was thrown.
// HashCode: 55530882
//
// Type:     System.Object
// Value:    System.Object
// HashCode: 30015890
//
// Type:     System.Version
// Value:    0.0
// HashCode: 1048575

Class DynamicInstanceList
    Private Shared instanceSpec As String = "System.EventArgs;System.Random;" + _
        "System.Exception;System.Object;System.Version"

    Public Shared Sub Main()
        Dim instances() As String = instanceSpec.Split(";")
        Dim instlist As Array = Array.CreateInstance(GetType(Object), instances.Length)
        Dim item As Object

        For i As Integer = 0 To instances.Length -1
            ' create the object from the specification string
            Console.WriteLine("Creating instance of: {0}", instances(i))
            item = Activator.CreateInstance(Type.GetType(instances(i)))
            instlist.SetValue(item, i)
        Next i
        Console.WriteLine(Environment.NewLine + "Objects and their default values:" + Environment.NewLine)
        For Each o As Object In instlist
            Console.WriteLine("Type:     {0}" + Environment.NewLine + "Value:    {1}" + _
                Environment.NewLine + "HashCode: {2}" + Environment.NewLine, _
                o.GetType().FullName, o.ToString(), o.GetHashCode())
        Next o
    End Sub
End Class

' This program will display output similar to the following:
'
' Creating instance of: System.EventArgs
' Creating instance of: System.Random
' Creating instance of: System.Exception
' Creating instance of: System.Object
' Creating instance of: System.Version
'
' Objects and their default values:
'
' Type:     System.EventArgs
' Value:    System.EventArgs
' HashCode: 46104728
'
' Type:     System.Random
' Value:    System.Random
' HashCode: 12289376
'
' Type:     System.Exception
' Value:    System.Exception: Exception of type 'System.Exception' was thrown.
' HashCode: 55530882
'
' Type:     System.Object
' Value:    System.Object
' HashCode: 30015890
'
' Type:     System.Version
' Value:    0.0
' HashCode: 1048575

Uwagi

Konstruktor, który ma być wywoływany, musi być dostępny.

Nuta

Począwszy od programu .NET Framework 2.0, ta metoda może służyć do uzyskiwania dostępu do typów niepublikacyjnych, jeśli obiekt wywołujący otrzymał ReflectionPermission z flagą ReflectionPermissionFlag.RestrictedMemberAccess, a jeśli zestaw dotacji zawierający typy niepublicowe jest ograniczony do zestawu dotacji obiektu wywołującego lub do jego podzbioru. (Zobacz zagadnienia dotyczące zabezpieczeń dotyczące odbicia). Aby korzystać z tej funkcji, aplikacja powinna być docelowa dla programu .NET Framework 3.5 lub nowszego.

CreateInstance<T>()

Źródło:

Activator.RuntimeType.cs

Tworzy wystąpienie typu wyznaczonego przez określony parametr typu ogólnego przy użyciu konstruktora bez parametrów.

public:
generic <typename T>
 static T CreateInstance();

public static T CreateInstance<T> ();

static member CreateInstance : unit -> 'T

Public Shared Function CreateInstance(Of T) () As T

Parametry typu

T

Typ do utworzenia.

Zwraca

T

Odwołanie do nowo utworzonego obiektu lub null dla wystąpień Nullable<T>.

Wyjątki

MissingMethodException

Nie można utworzyć wystąpienia klasy abstrakcyjnej lub typ określony dla T nie ma konstruktora bez parametrów.

Uwaga: w .NET dla aplikacji ze Sklepu Windows lub przenośnej biblioteki klasprzechwyć wyjątek klasy bazowej, MissingMemberException, zamiast tego.

Uwagi

Metoda ogólna CreateInstance<T>() jest używana przez kompilatory do implementowania wystąpienia typów określonych przez parametry typu. Na przykład w poniższej metodzie ogólnej implementacja new T() (gcnew T() w języku C++) używa metody ogólnej CreateInstance<T>().

public:
    generic <typename T> where T:gcnew()
    static T Bar()
    {
        return gcnew T();
    }

public static T Factory<T>() where T : new()
{
    return new T();
}

let factory<'T when 'T : (new: unit -> 'T)> =
    new 'T()

Public Shared Function Factory(Of T As New)() As T
    Return New T()
End Function

Ogólnie rzecz biorąc, nie ma zastosowania dla CreateInstance<T>() metody ogólnej w kodzie aplikacji, ponieważ typ musi być znany w czasie kompilacji. Jeśli typ jest znany w czasie kompilacji, można użyć normalnej składni wystąpienia (operatornew w języku C#, New w Visual Basic, gcnew w języku C++). Jeśli typ nie jest znany w czasie kompilacji, można wywołać nieogólne przeciążenie CreateInstance.

Nie ma przeciążeń metody ogólnej CreateInstance<T>(), które przyjmują listy argumentów, ponieważ nieogólne przeciążenia CreateInstance już zapewniają rozwiązanie konstruktora powiązanego z opóźnieniem.