Activator.CreateInstance Метод

Определение

Пространство имен:

System

Сборки:

netstandard.dll, System.Runtime.dll

Создает экземпляр указанного типа с помощью конструктора, который лучше всего соответствует указанным параметрам.

Перегрузки

Имя	Описание
CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Создает экземпляр типа, имя которого указано, используя именованную сборку и конструктор, который лучше всего соответствует указанным параметрам.
CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo, Object[])	Создает экземпляр указанного типа с помощью конструктора, который лучше всего соответствует указанным параметрам.
CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo)	Создает экземпляр указанного типа с помощью конструктора, который лучше всего соответствует указанным параметрам.
CreateInstance(Type, Object[], Object[])	Создает экземпляр указанного типа с помощью конструктора, который лучше всего соответствует указанным параметрам.
CreateInstance(String, String, Object[])	Создает экземпляр типа, имя которого указано с помощью именованной сборки и конструктора без параметров.
CreateInstance(Type, Object[])	Создает экземпляр указанного типа с помощью конструктора, который лучше всего соответствует указанным параметрам.
CreateInstance(Type, Boolean)	Создает экземпляр указанного типа с помощью конструктора без параметров этого типа.
CreateInstance(String, String)	Создает экземпляр типа, имя которого указано с помощью именованной сборки и конструктора без параметров.
CreateInstance(Type)	Создает экземпляр указанного типа с помощью конструктора без параметров этого типа.
CreateInstance<T>()	Создает экземпляр типа, указанного указанным параметром универсального типа, с помощью конструктора без параметров.

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

Исходный код:

Activator.RuntimeType.cs

Создает экземпляр типа, имя которого указано, используя именованную сборку и конструктор, который лучше всего соответствует указанным параметрам.

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

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

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

Параметры

assemblyName

String

Имя сборки, в которой выполняется поиск типа typeName . Если assemblyName это nullтак, выполняется поиск сборки.

typeName

String

Полное имя типа для создания экземпляра.

ignoreCase

Boolean

trueЗначение , чтобы указать, что поиск не учитывает регистр; false чтобы указать, что поиск typeName учитывает регистр.

bindingAttr

BindingFlags

Сочетание нулевых или более битовых флагов, влияющих на поиск конструктора typeName . Если bindingAttr значение равно нулю, выполняется поиск общедоступных конструкторов с учетом регистра.

binder

Binder

Объект, который использует и args ищет bindingAttr и определяет typeName конструктор. Если bindernull, используется привязка по умолчанию.

args

Object[]

Массив аргументов, соответствующих числу, порядку и типу параметров вызываемого конструктора. Если args это пустой массив или nullконструктор, который не принимает параметров (конструктор без параметров), вызывается.

culture

CultureInfo

Сведения, относящиеся к языку и региональным параметрам, которые управляют приведением args формальных типов, объявленных для конструктора typeName . В противном culturenullCultureInfo случае используется текущий поток.

activationAttributes

Object[]

Массив одного или нескольких атрибутов, которые могут участвовать в активации. Обычно это массив, содержащий один UrlAttribute объект, указывающий URL-адрес, необходимый для активации удаленного объекта.

Этот параметр связан с объектами, активированными клиентом. Активация клиента — это устаревшая технология, которая сохраняется для обратной совместимости, но не рекомендуется для новой разработки. Распределенные приложения должны использовать Windows Communication Foundation.

Возвращаемое значение

ObjectHandle

Дескриптор, который должен быть раскрыт для доступа к только что созданному экземпляру или null для Nullable<T> экземпляров без значения.

Атрибуты

RequiresUnreferencedCodeAttribute

Исключения

ArgumentNullException

typeName равно null.

MissingMethodException

Не найден соответствующий конструктор.

TypeLoadException

typeName не найден в assemblyName.

FileNotFoundException

assemblyName не найден.

MethodAccessException

Вызывающий объект не имеет разрешения на вызов этого конструктора.

MemberAccessException

Не удается создать экземпляр абстрактного класса или этот член был вызван с помощью механизма последней привязки.

TargetInvocationException

Конструктор, который был вызван с помощью отражения, вызвал исключение.

InvalidComObjectException

Тип COM не был получен или GetTypeFromProgIDGetTypeFromCLSIDне получен.

NotSupportedException

TypedReferenceСоздание , и ArgIteratorVoidтипов, или RuntimeArgumentHandle массивов этих типов, не поддерживается.

-или-

activationAttributes не является пустым массивом, и созданный тип не является производным от MarshalByRefObject.

-или-

Конструктор, который лучше всего соответствует argsvarargs аргументам.

BadImageFormatException

assemblyName не является допустимой сборкой.

-или-

Среда clR (CLR) версии 2.0 или более поздней версии в настоящее время загружается и assemblyName была скомпилирована для версии среды CLR, которая позже, чем текущая загруженная версия. Обратите внимание, что платформы .NET Framework версии 2.0, 3.0 и 3.5 используют среду CLR версии 2.0.

FileLoadException

Сборка или модуль была загружена дважды с двумя разными доказательствами.

-или-

Недопустимое имя сборки или база кода.

Комментарии

Используется ObjectHandle.Unwrap для распаковки возвращаемого значения.

В .NET Core 3.0 и более поздних версиях сборка загружается, активируемая этим API, зависит от текущего AssemblyLoadContext.CurrentContextualReflectionContextзначения.

Заметка

Этот метод можно использовать для создания неопубликованных типов и членов, если вызывающий объект был предоставлен ReflectionPermission с ReflectionPermissionFlag.RestrictedMemberAccess флагом, и если набор предоставления сборки, содержащей неопубликованные типы и члены, ограничены набором предоставления вызывающего объекта или подмножеством. (См. вопросы Security Для отражения.) Чтобы использовать эту функцию, приложение должно использовать платформу .NET Framework 3.5 или более поздней версии.

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

Исходный код:

Activator.RuntimeType.cs

Создает экземпляр указанного типа с помощью конструктора, который лучше всего соответствует указанным параметрам.

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

Параметры

type

Type

Тип создаваемого объекта.

bindingAttr

BindingFlags

Сочетание нулевых или более битовых флагов, влияющих на поиск конструктора type . Если bindingAttr значение равно нулю, выполняется поиск общедоступных конструкторов с учетом регистра.

binder

Binder

Объект, который использует и args ищет bindingAttr и определяет type конструктор. Если bindernull, используется привязка по умолчанию.

args

Object[]

Массив аргументов, соответствующих числу, порядку и типу параметров вызываемого конструктора. Если args это пустой массив или nullконструктор, который не принимает параметров (конструктор без параметров), вызывается.

culture

CultureInfo

Сведения, относящиеся к языку и региональным параметрам, которые управляют приведением args формальных типов, объявленных для конструктора type . В противном culturenullCultureInfo случае используется текущий поток.

activationAttributes

Object[]

Массив одного или нескольких атрибутов, которые могут участвовать в активации. Обычно это массив, содержащий один UrlAttribute объект, указывающий URL-адрес, необходимый для активации удаленного объекта.

Этот параметр связан с объектами, активированными клиентом. Активация клиента — это устаревшая технология, которая сохраняется для обратной совместимости, но не рекомендуется для новой разработки. Распределенные приложения должны использовать Windows Communication Foundation.

Возвращаемое значение

Object

Ссылка на только что созданный объект или null экземпляры Nullable<T> без значения.

Исключения

ArgumentNullException

type равно null.

ArgumentException

type не RuntimeTypeявляется .

-или-

type — открытый универсальный тип (т. е ContainsGenericParameters . возвращает trueсвойство).

NotSupportedException

type не может быть TypeBuilder.

-или-

TypedReferenceСоздание , и ArgIteratorVoidтипов, или RuntimeArgumentHandle массивов этих типов, не поддерживается.

-или-

activationAttributes не является пустым массивом, и созданный тип не является производным от MarshalByRefObject.

-или-

Сборка, содержащая type , является динамической сборкой, созданной с Saveпомощью .

-или-

Конструктор, который лучше всего соответствует argsvarargs аргументам.

TargetInvocationException

Вызываемый конструктор создает исключение.

MethodAccessException

Вызывающий объект не имеет разрешения на вызов этого конструктора.

MemberAccessException

Не удается создать экземпляр абстрактного класса или этот член был вызван с помощью механизма последней привязки.

InvalidComObjectException

Тип COM не был получен или GetTypeFromProgIDGetTypeFromCLSIDне получен.

MissingMethodException

Не найден соответствующий конструктор.

COMException

type — это COM-объект, но идентификатор класса, используемый для получения типа, является недопустимым, или определенный класс не зарегистрирован.

TypeLoadException

type недопустимый тип.

Комментарии

Вызываемый конструктор должен обеспечить наиболее конкретное совпадение с указанным списком аргументов в ограничениях указанных атрибутов привязки и привязки.

Заметка

Этот метод можно использовать для доступа к неопубликованным типам и членам, если вызывающий объект был предоставлен ReflectionPermission с ReflectionPermissionFlag.RestrictedMemberAccess помощью флага, и если набор разрешений типов и членов неопубликованного объекта ограничен набором предоставления вызывающего объекта или подмножеством. (См. вопросы Security Для отражения.) Чтобы использовать эту функцию, приложение должно использовать платформу .NET Framework 3.5 или более поздней версии.

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

Исходный код:

Activator.cs

Создает экземпляр указанного типа с помощью конструктора, который лучше всего соответствует указанным параметрам.

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

Параметры

type

Type

Тип создаваемого объекта.

bindingAttr

BindingFlags

Сочетание нулевых или более битовых флагов, влияющих на поиск конструктора type . Если bindingAttr значение равно нулю, выполняется поиск общедоступных конструкторов с учетом регистра.

binder

Binder

Объект, который использует и args ищет bindingAttr и определяет type конструктор. Если bindernull, используется привязка по умолчанию.

args

Object[]

Массив аргументов, соответствующих числу, порядку и типу параметров вызываемого конструктора. Если args это пустой массив или nullконструктор, который не принимает параметров (конструктор без параметров), вызывается.

culture

CultureInfo

Сведения, относящиеся к языку и региональным параметрам, которые управляют приведением args формальных типов, объявленных для конструктора type . В противном culturenullCultureInfo случае используется текущий поток.

Возвращаемое значение

Object

Ссылка на только что созданный объект или null экземпляры Nullable<T> без значения.

Исключения

ArgumentNullException

type равно null.

ArgumentException

type не RuntimeTypeявляется .

-или-

type — открытый универсальный тип (т. е ContainsGenericParameters . возвращает trueсвойство).

NotSupportedException

type не может быть TypeBuilder.

-или-

TypedReferenceСоздание , и ArgIteratorVoidтипов, или RuntimeArgumentHandle массивов этих типов, не поддерживается.

-или-

Сборка, содержащая type , является динамической сборкой, созданной с Saveпомощью .

-или-

Конструктор, который лучше всего соответствует argsvarargs аргументам.

TargetInvocationException

Вызываемый конструктор создает исключение.

MethodAccessException

Вызывающий объект не имеет разрешения на вызов этого конструктора.

MemberAccessException

Не удается создать экземпляр абстрактного класса или этот член был вызван с помощью механизма последней привязки.

InvalidComObjectException

Тип COM не был получен или GetTypeFromProgIDGetTypeFromCLSIDне получен.

MissingMethodException

Не найден соответствующий конструктор.

COMException

type — это COM-объект, но идентификатор класса, используемый для получения типа, является недопустимым, или определенный класс не зарегистрирован.

TypeLoadException

type недопустимый тип.

Комментарии

Вызываемый конструктор должен обеспечить наиболее конкретное совпадение с указанным списком аргументов в ограничениях указанных атрибутов привязки и привязки.

Заметка

Этот метод можно использовать для доступа к неопубликованным типам и членам, если вызывающий объект был предоставлен ReflectionPermission с ReflectionPermissionFlag.RestrictedMemberAccess флагом, и если набор предоставления сборки, содержащей типы и члены неопубликованного типа, ограничены набором предоставления вызывающего объекта или подмножеством. (См. вопросы Security Для отражения.) Чтобы использовать эту функцию, приложение должно использовать платформу .NET Framework 3.5 или более поздней версии.

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

Исходный код:

Activator.cs

Создает экземпляр указанного типа с помощью конструктора, который лучше всего соответствует указанным параметрам.

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

Параметры

type

Type

Тип создаваемого объекта.

args

Object[]

Массив аргументов, соответствующих числу, порядку и типу параметров вызываемого конструктора. Если args это пустой массив или nullконструктор, который не принимает параметров (конструктор без параметров), вызывается.

activationAttributes

Object[]

Массив одного или нескольких атрибутов, которые могут участвовать в активации. Обычно это массив, содержащий один UrlAttribute объект, указывающий URL-адрес, необходимый для активации удаленного объекта.

Этот параметр связан с объектами, активированными клиентом. Активация клиента — это устаревшая технология, которая сохраняется для обратной совместимости, но не рекомендуется для новой разработки. Распределенные приложения должны использовать Windows Communication Foundation.

Возвращаемое значение

Object

Ссылка на только что созданный объект или null экземпляры Nullable<T> без значения.

Исключения

ArgumentNullException

type равно null.

ArgumentException

type не RuntimeTypeявляется .

-или-

type — открытый универсальный тип (т. е ContainsGenericParameters . возвращает trueсвойство).

NotSupportedException

type не может быть TypeBuilder.

-или-

TypedReferenceСоздание , и ArgIteratorVoidтипов, или RuntimeArgumentHandle массивов этих типов, не поддерживается.

-или-

activationAttributes не является пустым массивом, и созданный тип не является производным от MarshalByRefObject.

-или-

Сборка, содержащая type , является динамической сборкой, созданной с Saveпомощью .

-или-

Конструктор, который лучше всего соответствует argsvarargs аргументам.

TargetInvocationException

Вызываемый конструктор создает исключение.

MethodAccessException

Вызывающий объект не имеет разрешения на вызов этого конструктора.

MemberAccessException

Не удается создать экземпляр абстрактного класса или этот член был вызван с помощью механизма последней привязки.

InvalidComObjectException

Тип COM не был получен или GetTypeFromProgIDGetTypeFromCLSIDне получен.

MissingMethodException

Не найдено соответствующего общедоступного конструктора.

COMException

type — это COM-объект, но идентификатор класса, используемый для получения типа, является недопустимым, или определенный класс не зарегистрирован.

TypeLoadException

type недопустимый тип.

Комментарии

Вызываемый конструктор должен быть доступен и должен обеспечить наиболее конкретное совпадение с указанным списком аргументов.

Заметка

Этот метод можно использовать для доступа к неопубликованным типам, если вызывающий объект был предоставлен ReflectionPermission с ReflectionPermissionFlag.RestrictedMemberAccess флагом, и если набор предоставления сборки, содержащей типы неопубликованных, ограничен набором предоставления вызывающего объекта или подмножеством. (См. вопросы Security Для отражения.) Чтобы использовать эту функцию, приложение должно использовать платформу .NET Framework 3.5 или более поздней версии.

CreateInstance(String, String, Object[])

Исходный код:

Activator.RuntimeType.cs

Создает экземпляр типа, имя которого указано с помощью именованной сборки и конструктора без параметров.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, 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? CreateInstance(string assemblyName, string typeName, object?[]? activationAttributes);

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

Параметры

assemblyName

String

Имя сборки, в которой выполняется поиск типа typeName . Если assemblyName это nullтак, выполняется поиск сборки.

typeName

String

Полное имя типа для создания экземпляра.

activationAttributes

Object[]

Массив одного или нескольких атрибутов, которые могут участвовать в активации. Обычно это массив, содержащий один UrlAttribute объект, указывающий URL-адрес, необходимый для активации удаленного объекта.

Этот параметр связан с объектами, активированными клиентом. Активация клиента — это устаревшая технология, которая сохраняется для обратной совместимости, но не рекомендуется для новой разработки. Распределенные приложения должны использовать Windows Communication Foundation.

Возвращаемое значение

ObjectHandle

Дескриптор, который должен быть раскрыт для доступа к только что созданному объекту или null для Nullable<T> экземпляров.

Атрибуты

RequiresUnreferencedCodeAttribute

Исключения

ArgumentNullException

typeName равно null.

MissingMethodException

Не найдено соответствующего общедоступного конструктора.

TypeLoadException

typeName не найден в assemblyName.

FileNotFoundException

assemblyName не найден.

MethodAccessException

Вызывающий объект не имеет разрешения на вызов этого конструктора.

MemberAccessException

Не удается создать экземпляр абстрактного класса или этот член был вызван с помощью механизма последней привязки.

InvalidComObjectException

Тип COM не был получен или GetTypeFromProgIDGetTypeFromCLSIDне получен.

NotSupportedException

TypedReferenceСоздание , и ArgIteratorVoidтипов, или RuntimeArgumentHandle массивов этих типов, не поддерживается.

-или-

activationAttributes не является пустым массивом, и созданный тип не является производным от MarshalByRefObject.

-или-

activationAttributes не является UrlAttribute

массив.

BadImageFormatException

assemblyName не является допустимой сборкой.

-или-

Среда clR (CLR) версии 2.0 или более поздней версии в настоящее время загружается и assemblyName была скомпилирована для версии среды CLR, которая позже, чем текущая загруженная версия. Обратите внимание, что платформы .NET Framework версии 2.0, 3.0 и 3.5 используют среду CLR версии 2.0.

FileLoadException

Сборка или модуль была загружена дважды с двумя разными доказательствами.

-или-

Недопустимое имя сборки или база кода.

TargetInvocationException

Вызываемый конструктор создает исключение.

-или-

Ошибка при попытке удаленной активации в целевом объекте, указанном в activationAttributes.

Комментарии

Используется ObjectHandle.Unwrap для распаковки возвращаемого значения.

В .NET Core 3.0 и более поздних версиях сборка загружается, активируемая этим API, зависит от текущего AssemblyLoadContext.CurrentContextualReflectionContextзначения.

Заметка

Этот метод можно использовать для создания неопубликованных типов, если вызывающий объект был предоставлен ReflectionPermission с ReflectionPermissionFlag.RestrictedMemberAccess помощью флага, и если набор разрешений неопубликованных типов ограничен набором предоставления вызывающего объекта или подмножеством. (См. вопросы Security Для отражения.) Чтобы использовать эту функцию, приложение должно использовать платформу .NET Framework 3.5 или более поздней версии.

CreateInstance(Type, Object[])

Исходный код:

Activator.cs

Создает экземпляр указанного типа с помощью конструктора, который лучше всего соответствует указанным параметрам.

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

Параметры

type

Type

Тип создаваемого объекта.

args

Object[]

Массив аргументов, соответствующих числу, порядку и типу параметров вызываемого конструктора. Если args это пустой массив или nullконструктор, который не принимает параметров (конструктор без параметров), вызывается.

Возвращаемое значение

Object

Ссылка на только что созданный объект или null экземпляры Nullable<T> без значения.

Исключения

ArgumentNullException

type равно null.

ArgumentException

type не RuntimeTypeявляется .

-или-

type — открытый универсальный тип (т. е ContainsGenericParameters . возвращает trueсвойство).

NotSupportedException

type не может быть TypeBuilder.

-или-

TypedReferenceСоздание , и ArgIteratorVoidтипов, или RuntimeArgumentHandle массивов этих типов, не поддерживается.

-или-

Сборка, содержащая type , является динамической сборкой, созданной с Saveпомощью .

-или-

Конструктор, который лучше всего соответствует argsvarargs аргументам.

TargetInvocationException

Вызываемый конструктор создает исключение.

MethodAccessException

Вызывающий объект не имеет разрешения на вызов этого конструктора.

MemberAccessException

Не удается создать экземпляр абстрактного класса или этот член был вызван с помощью механизма последней привязки.

InvalidComObjectException

Тип COM не был получен или GetTypeFromProgIDGetTypeFromCLSIDне получен.

MissingMethodException

Не найдено соответствующего общедоступного конструктора.

COMException

type — это COM-объект, но идентификатор класса, используемый для получения типа, является недопустимым, или определенный класс не зарегистрирован.

TypeLoadException

type недопустимый тип.

Примеры

В следующем примере вызывается CreateInstance(Type, Object[]) метод для создания String объекта. Он вызывает String.String(Char[], Int32, Int32) конструктор для создания экземпляра строки, содержащей десять элементов из массива символов, начиная с четырнадцатой позиции.

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

В следующем примере создается массив, элементы которого являются аргументами, передаваемыми конструктору String . Затем в этом примере каждый массив CreateInstance(Type, Object[]) передается методу для вызова соответствующего конструктора строк.

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

Комментарии

Вызываемый конструктор должен быть доступен и должен обеспечить наиболее конкретное совпадение с указанным списком аргументов.

Заметка

Этот метод можно использовать для доступа к неопубликованным типам, если вызывающий объект был предоставлен ReflectionPermission с ReflectionPermissionFlag.RestrictedMemberAccess флагом, и если набор предоставления сборки, содержащей типы неопубликованных, ограничен набором предоставления вызывающего объекта или подмножеством. (См. вопросы Security Для отражения.) Чтобы использовать эту функцию, приложение должно использовать платформу .NET Framework 3.5 или более поздней версии.

CreateInstance(Type, Boolean)

Исходный код:

Activator.RuntimeType.cs

Создает экземпляр указанного типа с помощью конструктора без параметров этого типа.

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

Параметры

type

Type

Тип создаваемого объекта.

nonPublic

Boolean

true Значение , если открытый или неопубликованный конструктор без параметров может соответствовать; false Значение , если может соответствовать только открытый конструктор без параметров.

Возвращаемое значение

Object

Ссылка на только что созданный объект или null экземпляры Nullable<T> .

Исключения

ArgumentNullException

type равно null.

ArgumentException

type не RuntimeTypeявляется .

-или-

type — открытый универсальный тип (т. е ContainsGenericParameters . возвращает trueсвойство).

NotSupportedException

type не может быть TypeBuilder.

-или-

TypedReferenceСоздание , и ArgIteratorVoidтипов, или RuntimeArgumentHandle массивов этих типов, не поддерживается.

-или-

Сборка, содержащая type , является динамической сборкой, созданной с Saveпомощью .

TargetInvocationException

Вызываемый конструктор создает исключение.

MethodAccessException

Вызывающий объект не имеет разрешения на вызов этого конструктора.

MemberAccessException

Не удается создать экземпляр абстрактного класса или этот член был вызван с помощью механизма последней привязки.

InvalidComObjectException

Тип COM не был получен или GetTypeFromProgIDGetTypeFromCLSIDне получен.

MissingMethodException

Не найдено соответствующего общедоступного конструктора.

COMException

type — это COM-объект, но идентификатор класса, используемый для получения типа, является недопустимым, или определенный класс не зарегистрирован.

TypeLoadException

type недопустимый тип.

Комментарии

Заметка

Этот метод можно использовать для доступа к неопубликованным типам и членам, если вызывающий объект был предоставлен ReflectionPermission с ReflectionPermissionFlag.RestrictedMemberAccess флагом, и если набор предоставления сборки, содержащей типы и члены неопубликованного типа, ограничены набором предоставления вызывающего объекта или подмножеством. (См. вопросы Security Для отражения.) Чтобы использовать эту функцию, приложение должно использовать платформу .NET Framework 3.5 или более поздней версии.

CreateInstance(String, String)

Исходный код:

Activator.RuntimeType.cs

Создает экземпляр типа, имя которого указано с помощью именованной сборки и конструктора без параметров.

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

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

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
static member CreateInstance : string * string -> System.Runtime.Remoting.ObjectHandle

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

Параметры

assemblyName

String

Имя сборки, в которой выполняется поиск типа typeName . Если assemblyName это nullтак, выполняется поиск сборки.

typeName

String

Полное имя типа для создания экземпляра.

Возвращаемое значение

ObjectHandle

Дескриптор, который должен быть раскрыт для доступа к только что созданному объекту или null для Nullable<T> экземпляров.

Атрибуты

RequiresUnreferencedCodeAttribute

Исключения

ArgumentNullException

typeName равно null.

MissingMethodException

Не найдено соответствующего общедоступного конструктора.

TypeLoadException

typeName не найден в assemblyName.

FileNotFoundException

assemblyName не найден.

MethodAccessException

Вызывающий объект не имеет разрешения на вызов этого конструктора.

MemberAccessException

Невозможно создать экземпляр абстрактного класса или этот член был вызван с помощью механизма последней привязки.

TargetInvocationException

Конструктор, который был вызван с помощью отражения, вызвал исключение.

InvalidComObjectException

Тип COM не был получен или GetTypeFromProgIDGetTypeFromCLSIDне получен.

NotSupportedException

TypedReferenceСоздание , и ArgIteratorVoidтипов, или RuntimeArgumentHandle массивов этих типов, не поддерживается.

BadImageFormatException

assemblyName не является допустимой сборкой.

-или-

Среда clR (CLR) версии 2.0 или более поздней версии в настоящее время загружается и assemblyName была скомпилирована для версии среды CLR, которая позже, чем текущая загруженная версия. Обратите внимание, что платформы .NET Framework версии 2.0, 3.0 и 3.5 используют среду CLR версии 2.0.

FileLoadException

Сборка или модуль была загружена дважды с двумя разными доказательствами.

-или-

Недопустимое имя сборки или база кода.

Примеры

В следующем примере определяется класс с именем PersonPersonInfoсборки. Обратите внимание, что класс Person имеет два конструктора, один из которых является параметрным.

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

В следующем примере метод вызывается CreateInstance(String, String) для создания экземпляра Person класса. Для этого требуется ссылка на PersonInfo.dll добавить в проект. CreateInstance(String, String) Так как метод вызывает Person конструктор без параметров класса, в примере присваивается значение его 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

CreateInstance Однако часто вызывается для создания экземпляра типа, пересекающего границы компьютера или не известного во время разработки. В этом случае нельзя включить ссылку на сборку в проекте и не удается выполнить вызовы с ранними привязками к членам типа. Для обхода этого ограничения в следующем примере метод используется CreateInstance вместе с отражением для назначения значения Person свойству объекта Name и отображения его значения.

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

Комментарии

Используется ObjectHandle.Unwrap для распаковки возвращаемого значения.

assemblyName может быть любой из следующих вариантов:

• Простое имя сборки без его пути или расширения файла. Например, для сборки, TypeExtensions путь и имя которой —\bin\TypeExtensions.dll.

• Полное имя подписанной сборки, которая состоит из его простого имени, версии, языка и региональных параметров и маркера открытого ключа; Например, "TypeExtensions, Version=1.0.0.0, Culture=neutral, PublicKeyToken=181869f2f7435b51".

Дополнительные сведения о том, как среда CLR идентифицирует и загружает сборки, см. в разделе "Поиск сборок среды выполнения". Сведения об использовании файла конфигурации приложения для определения расположений сборок см. в разделе "Указание расположения сборки". Если assemblyName он найден, он загружается в контексте по умолчанию.

В .NET Core 3.0 и более поздних версиях сборка загружается, активируемая этим API, зависит от текущего AssemblyLoadContext.CurrentContextualReflectionContextзначения.

Заметка

Этот метод можно использовать для создания неопубликованных типов, если вызывающий объект был предоставлен ReflectionPermission с ReflectionPermissionFlag.RestrictedMemberAccess флагом, и если набор предоставления сборки, содержащей типы неопубликованных, ограничен набором предоставления вызывающего объекта или подмножеством. (См. вопросы Security Для отражения.) Чтобы использовать эту функцию, приложение должно использовать платформу .NET Framework 3.5 или более поздней версии.

CreateInstance(Type)

Исходный код:

Activator.cs

Создает экземпляр указанного типа с помощью конструктора без параметров этого типа.

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

Параметры

type

Type

Тип создаваемого объекта.

Возвращаемое значение

Object

Ссылка на только что созданный объект или null экземпляры Nullable<T> .

Исключения

ArgumentNullException

type равно null.

ArgumentException

type не RuntimeTypeявляется .

-или-

type — открытый универсальный тип (т. е ContainsGenericParameters . возвращает trueсвойство).

NotSupportedException

type не может быть TypeBuilder.

-или-

TypedReferenceСоздание , и ArgIteratorVoidтипов, или RuntimeArgumentHandle массивов этих типов, не поддерживается.

-или-

Сборка, содержащая type , является динамической сборкой, созданной с Saveпомощью .

TargetInvocationException

Вызываемый конструктор создает исключение.

MethodAccessException

Вызывающий объект не имеет разрешения на вызов этого конструктора.

MemberAccessException

Не удается создать экземпляр абстрактного класса или этот член был вызван с помощью механизма последней привязки.

InvalidComObjectException

Тип COM не был получен или GetTypeFromProgIDGetTypeFromCLSIDне получен.

MissingMethodException

Не найдено соответствующего общедоступного конструктора.

COMException

type — это COM-объект, но идентификатор класса, используемый для получения типа, является недопустимым, или определенный класс не зарегистрирован.

TypeLoadException

type недопустимый тип.

Примеры

В следующем примере кода показано, как вызвать CreateInstance(Type) метод. Создаются экземпляры нескольких различных типов и отображаются значения по умолчанию.

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

Комментарии

Вызываемый конструктор должен быть доступен.

Заметка

Этот метод можно использовать для доступа к неопубликованным типам, если вызывающий объект был предоставлен ReflectionPermission с ReflectionPermissionFlag.RestrictedMemberAccess флагом, и если набор предоставления сборки, содержащей типы неопубликованных, ограничен набором предоставления вызывающего объекта или подмножеством. (См. вопросы Security Для отражения.) Чтобы использовать эту функцию, приложение должно использовать платформу .NET Framework 3.5 или более поздней версии.

CreateInstance<T>()

Исходный код:

Activator.RuntimeType.cs

Создает экземпляр типа, указанного указанным параметром универсального типа, с помощью конструктора без параметров.

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

public static T CreateInstance<T>() where T : allows ref struct;

static member CreateInstance : unit -> 'T

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

Параметры типа

T

Тип для создания.

Возвращаемое значение

T

Ссылка на только что созданный объект или null экземпляры Nullable<T> .

Исключения

MissingMethodException

Не удается создать экземпляр абстрактного класса или тип, указанный для T нее, не имеет конструктора без параметров.

Комментарии

Универсальный CreateInstance<T>() метод используется компиляторами для реализации экземпляра типов, указанных параметрами типа. Например, в следующем универсальном методе реализация new T() использует универсальный CreateInstance<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

Как правило, универсальный CreateInstance<T>() метод в коде приложения не используется, так как тип должен быть известен во время компиляции. Если тип известен во время компиляции, можно использовать обычный синтаксис экземпляра (new оператор в C#, New в Visual Basic). Если тип не известен во время компиляции, можно вызвать не универсальную перегрузку CreateInstance.

Нет перегрузок универсального CreateInstance<T>() метода, которые принимают списки аргументов CreateInstance , так как не универсальные перегрузки уже предоставляют разрешение конструктора с поздней привязкой.