Activator.CreateInstanceFrom 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

使用指定的程序集文件和与指定参数匹配程度最高的构造函数来创建指定名称的类型的实例。

重载

CreateInstanceFrom(String, String, Object[])	使用已命名的程序集文件和无参数构造函数，创建名称已指定的类型的实例。
CreateInstanceFrom(String, String)	使用已命名的程序集文件和无参数构造函数，创建名称已指定的类型的实例。
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	使用指定的程序集文件和与指定参数匹配程度最高的构造函数来创建指定名称的类型的实例。

CreateInstanceFrom(String, String, Object[])

Source:

Activator.cs

使用已命名的程序集文件和无参数构造函数，创建名称已指定的类型的实例。

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

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

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

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

参数

assemblyFile

String

包含某程序集的文件的名称，将在该程序集内查找名为 typeName 的类型。

typeName

String

要为其创建实例的类型的名称。

activationAttributes

Object[]

包含一个或多个可以参与激活的特性的数组。 这通常为包含单个 UrlAttribute 对象的数组，该对象指定激活远程对象所需的 URL。

此参数与客户端激活的对象相关。 客户端激活是一项传统技术，保留用于向后兼容，但不建议用于新的开发。 应改用 Windows Communication Foundation 来开发分布式应用程序。

返回

ObjectHandle

必须解包才能访问新创建的对象或 null 实例 Nullable<T> 的句柄。

例外

ArgumentNullException

typeName 为 null。

MissingMethodException

未找到匹配的公共构造函数。

TypeLoadException

在 assemblyFile 中未找到 typename。

FileNotFoundException

未找到 assemblyFile。

MethodAccessException

调用方没有权限调用此构造函数。

MemberAccessException

无法创建抽象类的实例，或者此成员是使用晚期绑定机制调用的。

TargetInvocationException

通过反射调用的构造函数引发异常。

NotSupportedException

activationAttributes 不是空数组，且正在创建的类型不是从 MarshalByRefObject 派生得来的。

SecurityException

调用方确实具有所需的 FileIOPermission。

BadImageFormatException

assemblyFile 不是有效的程序集。

- 或 -

当前已加载公共语言运行时 (CLR) 2.0 或更新版本，但 assemblyName 是使用比当前加载版本更新的 CLR 版本编译的。 请注意，.NET Framework 2.0、3.0 和 3.5 都使用 CLR 2.0。

注解

ObjectHandle.Unwrap使用 方法可解包返回值。

有关可由调用的方法引发的其他异常的信息，请参阅 和 CreateInstance 方法的Assembly.LoadFrom异常部分。

CreateInstanceFrom(String, String)

Source:

Activator.cs

使用已命名的程序集文件和无参数构造函数，创建名称已指定的类型的实例。

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

public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName);

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

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

参数

assemblyFile

String

包含某程序集的文件的名称，将在该程序集内查找名为 typeName 的类型。

typeName

String

要为其创建实例的类型的名称。

返回

ObjectHandle

必须解包才能访问新创建的对象或 null 实例 Nullable<T> 的句柄。

例外

ArgumentNullException

typeName 为 null。

MissingMethodException

未找到匹配的公共构造函数。

TypeLoadException

在 assemblyFile 中未找到 typename。

FileNotFoundException

未找到 assemblyFile。

MethodAccessException

调用方没有权限调用此构造函数。

MemberAccessException

无法创建抽象类的实例，或者此成员是使用晚期绑定机制调用的。

TargetInvocationException

通过反射调用的构造函数引发异常。

SecurityException

调用方确实具有所需的 FileIOPermission。

BadImageFormatException

assemblyFile 不是有效的程序集。

- 或 -

当前已加载公共语言运行时 (CLR) 2.0 或更新版本，但 assemblyName 是使用比当前加载版本更新的 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, 
                                  SomeType::typeid->FullName);

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

st->DoSomething(5);

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

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

st.DoSomething(5);

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

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

st.DoSomething 5

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

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

st.DoSomething(5)

注解

ObjectHandle.Unwrap使用 方法可解包返回值。

有关可由调用的方法引发的其他异常的信息，请参阅 和 CreateInstance 方法的Assembly.LoadFrom异常部分。

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

Source:

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

public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);

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

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

参数

assemblyFile

String

包含某程序集的文件的名称，将在该程序集内查找名为 typeName 的类型。

typeName

String

要为其创建实例的类型的名称。

ignoreCase

Boolean

使用 true 指定对 typeName 的搜索不区分大小写；使用 false 则指定搜索区分大小写。

bindingAttr

BindingFlags

影响 typeName 构造函数搜索的零个或多个位标志的组合。 如果 bindingAttr 为零，则对公共构造函数进行区分大小写的搜索。

binder

Binder

使用 bindingAttr 和 args 来查找和标识 typeName 构造函数的对象。 如果 binder 为 null，则使用默认联编程序。

args

Object[]

与要调用的构造函数的参数的编号、顺序和类型匹配的参数数组。 如果 args 为空数组或 null，则调用不带任何参数的构造函数（无参数构造函数）。

culture

CultureInfo

区域性特定的信息，这些信息控制将 args 强制转换为 typeName 构造函数所声明的正式类型。 如果 culture 为 null，则使用当前线程的 CultureInfo。

activationAttributes

Object[]

包含一个或多个可以参与激活的特性的数组。 这通常为包含单个 UrlAttribute 对象的数组，该对象指定激活远程对象所需的 URL。

此参数与客户端激活的对象相关。 客户端激活是一项传统技术，保留用于向后兼容，但不建议用于新的开发。 应改用 Windows Communication Foundation 来开发分布式应用程序。

返回

ObjectHandle

必须取消包装才能访问新创建的对象或 null 实例 Nullable<T> 的句柄。

例外

ArgumentNullException

typeName 为 null。

MissingMethodException

未找到匹配的构造函数。

TypeLoadException

在 assemblyFile 中未找到 typename。

FileNotFoundException

未找到 assemblyFile。

MethodAccessException

调用方没有权限调用此构造函数。

MemberAccessException

无法创建抽象类的实例，或者此成员是使用晚期绑定机制调用的。

TargetInvocationException

通过反射调用的构造函数引发异常。

SecurityException

调用方没有所要求的 FileIOPermission。

NotSupportedException

activationAttributes 不是空数组，且正在创建的类型不是从 MarshalByRefObject 派生得来的。

BadImageFormatException

assemblyFile 不是有效的程序集。

- 或 -

当前已加载公共语言运行时 (CLR) 2.0 或更新版本，但 assemblyName 是使用比当前加载版本更新的 CLR 版本编译的。 请注意，.NET Framework 2.0、3.0 和 3.5 都使用 CLR 2.0。

注解

ObjectHandle.Unwrap使用 方法解包返回值。

有关可由调用的方法引发的其他异常的信息，请参阅 和 CreateInstance 方法的 Assembly.LoadFrom Exceptions 部分。