Activator.CreateInstanceFrom Метод

Определение

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

System

Сборки:

netstandard.dll, System.Runtime.dll

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

Перегрузки

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

CreateInstanceFrom(String, String, Object[])

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

Activator.cs

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

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

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

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

Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String, activationAttributes As Object()) As ObjectHandle

Параметры

assemblyFile

String

Имя файла, содержащего сборку, в которой выполняется поиск типа typeName .

typeName

String

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

activationAttributes

Object[]

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

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

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

ObjectHandle

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

Атрибуты

RequiresUnreferencedCodeAttribute

Исключения

ArgumentNullException

typeName равно null.

MissingMethodException

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

TypeLoadException

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

FileNotFoundException

assemblyFile не найден.

MethodAccessException

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

MemberAccessException

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

TargetInvocationException

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

NotSupportedException

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

SecurityException

Вызывающий объект имеет обязательный параметр FileIOPermission.

BadImageFormatException

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

–или–

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

Комментарии

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

Сведения о других исключениях, которые могут быть вызваны с помощью вызываемых методов, см. в разделе Assembly.LoadFrom "Исключения" и CreateInstance "Методы".

CreateInstanceFrom(String, String)

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

Activator.cs

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

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName);

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

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

Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String) As ObjectHandle

Параметры

assemblyFile

String

Имя файла, содержащего сборку, в которой выполняется поиск типа typeName .

typeName

String

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

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

ObjectHandle

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

Атрибуты

RequiresUnreferencedCodeAttribute

Исключения

ArgumentNullException

typeName равно null.

MissingMethodException

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

TypeLoadException

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

FileNotFoundException

assemblyFile не найден.

MethodAccessException

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

MemberAccessException

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

TargetInvocationException

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

SecurityException

Вызывающий объект имеет обязательный параметр FileIOPermission.

BadImageFormatException

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

–или–

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

Примеры

В следующем примере кода показано, как вызвать CreateInstanceFrom метод. Этот пример кода является частью более крупного примера, предоставленного для Activator класса.

// Create an instance of the SomeType class that is defined in this
// assembly.
System.Runtime.Remoting.ObjectHandle oh =
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase,
                                 typeof(SomeType).FullName);

// Call an instance method defined by the SomeType type using this object.
SomeType st = (SomeType) oh.Unwrap();

st.DoSomething(5);

// Create an instance of the SomeType class that is defined in this assembly.
let oh = 
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().Location, typeof<SomeType>.FullName)

// Call an instance method defined by the SomeType type using this object.
let st = oh.Unwrap() :?> SomeType

st.DoSomething 5

' Create an instance of the SomeType class that is defined in this assembly.
Dim oh As System.Runtime.Remoting.ObjectHandle = _
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase, _
                                 GetType(SomeType).FullName)

' Call an instance method defined by the SomeType type using this object.
Dim st As SomeType = CType(oh.Unwrap(), SomeType)

st.DoSomething(5)

Комментарии

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

Сведения о других исключениях, которые могут быть вызваны с помощью вызываемых методов, см. в разделе Assembly.LoadFrom "Исключения" и CreateInstance "Методы".

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

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

Activator.cs

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

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName, bool ignoreCase, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture, cli::array <System::Object ^> ^ activationAttributes);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")]
public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom(string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
static member CreateInstanceFrom : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandle

Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object()) As ObjectHandle

Параметры

assemblyFile

String

Имя файла, содержащего сборку, в которой выполняется поиск типа typeName .

typeName

String

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

ignoreCase

Boolean

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

bindingAttr

BindingFlags

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

binder

Binder

Объект, который использует и bindingAttr ищет args и определяет 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 не найден в assemblyFile.

FileNotFoundException

assemblyFile не найден.

MethodAccessException

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

MemberAccessException

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

TargetInvocationException

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

SecurityException

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

NotSupportedException

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

BadImageFormatException

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

–или–

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

Комментарии

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

Сведения о других исключениях, которые могут быть вызваны с помощью вызываемых методов, см. в разделе Assembly.LoadFrom "Исключения" и CreateInstance "Методы".