AppDomain.CreateInstanceFromAndUnwrap 方法

參考

定義

命名空間:: System

組件:: System.Runtime.dll

組件:: System.Runtime.Extensions.dll

組件:: mscorlib.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

建立指定組件檔案中所定義之指定類型的新執行個體。

多載

CreateInstanceFromAndUnwrap(String, String)	建立指定組件檔案中所定義之指定類型的新執行個體。
CreateInstanceFromAndUnwrap(String, String, Object[])	建立指定組件檔案中所定義之指定類型的新執行個體。
CreateInstanceFromAndUnwrap(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	藉由指定是否忽略類型名稱的大小寫、用於選取要建立之類型的繫結屬性和繫結器、建構函式的引數、文化特性，以及啟動屬性，為指定之組件檔中定義的指定類型，建立新的執行個體。
CreateInstanceFromAndUnwrap(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)	已淘汰. 建立指定組件檔案中所定義之指定類型的新執行個體。

CreateInstanceFromAndUnwrap(String, String)

來源:: AppDomain.cs

來源:: AppDomain.cs

來源:: AppDomain.cs

建立指定組件檔案中所定義之指定類型的新執行個體。

public:
 System::Object ^ CreateInstanceFromAndUnwrap(System::String ^ assemblyFile, System::String ^ typeName);

public:
 System::Object ^ CreateInstanceFromAndUnwrap(System::String ^ assemblyName, System::String ^ typeName);

public object? CreateInstanceFromAndUnwrap (string assemblyFile, string typeName);

public object CreateInstanceFromAndUnwrap (string assemblyName, string typeName);

member this.CreateInstanceFromAndUnwrap : string * string -> obj

member this.CreateInstanceFromAndUnwrap : string * string -> obj

Public Function CreateInstanceFromAndUnwrap (assemblyFile As String, typeName As String) As Object

Public Function CreateInstanceFromAndUnwrap (assemblyName As String, typeName As String) As Object

參數

assemblyFileassemblyName: String

typeName: String

FullName 屬性傳回的要求類型之完整名稱 (包括命名空間，但不包括組件)。

傳回

Object

要求的物件；當找不到 typeName 時，則為 null。

例外狀況

ArgumentNullException

assemblyName 為 null。

-或-

typeName 為 null。

AppDomainUnloadedException

嘗試對卸載的應用程式定義域執行作業。

FileNotFoundException

找不到 assemblyName。

TypeLoadException

在 assemblyName 中找不到 typeName。

MissingMethodException

找不到無參數的公用建構函式。

MethodAccessException

呼叫端沒有足以呼叫這個建構函式的權限。

BadImageFormatException

assemblyName 不是目前載入運行時間的有效元件。

FileLoadException

使用兩個不同的辨識項載入組件或模組兩次。

備註

這是結合 CreateInstanceFrom 和 ObjectHandle.Unwrap的便利方法。這個方法會呼叫的 typeName無參數建構函式。

如需詳細資訊，請參閱 Activator.CreateInstanceFrom 方法。

另請參閱

CreateInstanceFrom(String, String)

適用於

CreateInstanceFromAndUnwrap(String, String, Object[])

來源:: AppDomain.cs

來源:: AppDomain.cs

來源:: AppDomain.cs

建立指定組件檔案中所定義之指定類型的新執行個體。

public:
 System::Object ^ CreateInstanceFromAndUnwrap(System::String ^ assemblyFile, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);

public:
 System::Object ^ CreateInstanceFromAndUnwrap(System::String ^ assemblyName, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);

public object? CreateInstanceFromAndUnwrap (string assemblyFile, string typeName, object?[]? activationAttributes);

public object CreateInstanceFromAndUnwrap (string assemblyName, string typeName, object[] activationAttributes);

member this.CreateInstanceFromAndUnwrap : string * string * obj[] -> obj

member this.CreateInstanceFromAndUnwrap : string * string * obj[] -> obj

Public Function CreateInstanceFromAndUnwrap (assemblyFile As String, typeName As String, activationAttributes As Object()) As Object

Public Function CreateInstanceFromAndUnwrap (assemblyName As String, typeName As String, activationAttributes As Object()) As Object

參數

assemblyFileassemblyName: String

typeName: String

所要求類型的完整名稱，包括命名空間，但不包括組件 (請參閱 FullName 屬性)。

activationAttributes: Object[]

一或多個屬性的陣列，此屬性可參與啟動過程。陣列通常只會包含一個 UrlAttribute 物件來指定用以啟動遠端物件的 URL。

此參數與 client-activated 物件有關。用戶端啟動是一項舊的技術，保留目的在提供回溯相容性，不建議用於新的開發。分散式應用程式應該改用 Windows Communication Foundation。

傳回

Object

要求的物件；當找不到 typeName 時，則為 null。

例外狀況

ArgumentNullException

assemblyName 為 null。

-或-

typeName 為 null。

NotSupportedException

呼叫者無法提供非繼承自 MarshalByRefObject 之物件的啟動屬性。

AppDomainUnloadedException

嘗試對卸載的應用程式定義域執行作業。

FileNotFoundException

找不到 assemblyName。

TypeLoadException

在 assemblyName 中找不到 typeName。

MissingMethodException

找不到無參數的公用建構函式。

MethodAccessException

呼叫端沒有足以呼叫這個建構函式的權限。

BadImageFormatException

assemblyName 不是目前載入運行時間的有效元件。

FileLoadException

使用兩個不同的辨識項載入組件或模組兩次。

備註

這是結合 CreateInstanceFrom 和 ObjectHandle.Unwrap的便利方法。這個方法會呼叫的 typeName無參數建構函式。

如需這個方法的詳細資訊，請參閱 Activator.CreateInstanceFrom 方法。

另請參閱

CreateInstanceFrom(String, String)

適用於

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

來源:: AppDomain.cs

來源:: AppDomain.cs

來源:: AppDomain.cs

藉由指定是否忽略類型名稱的大小寫、用於選取要建立之類型的繫結屬性和繫結器、建構函式的引數、文化特性，以及啟動屬性，為指定之組件檔中定義的指定類型，建立新的執行個體。

public:
 System::Object ^ CreateInstanceFromAndUnwrap(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 object? CreateInstanceFromAndUnwrap (string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);

public object CreateInstanceFromAndUnwrap (string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);

member this.CreateInstanceFromAndUnwrap : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> obj

Public Function CreateInstanceFromAndUnwrap (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 Object

參數

assemblyFile: String

定義所要求類型之組件的檔案名稱與路徑。

typeName: String

FullName 屬性傳回的要求類型之完整名稱 (包括命名空間，但不包括組件)。

ignoreCase: Boolean

布林值，指出是否執行區分大小寫的搜尋。

bindingAttr: BindingFlags

零或多個位元旗標的組合，此位元旗標會影響 typeName 建構函式的搜尋。如果 bindingAttr 為零，則會針對公用建構函式執行區分大小寫的搜尋。

binder: Binder

使用反映來啟用繫結、強制引數的類型、成員的引動過程，和擷取 MemberInfo 物件的物件。如果 binder 為 null，則會使用預設繫結器。

args: Object[]

要傳遞到建構函式的引數。這個引數陣列必須在數目、順序和類型上符合要叫用之建構函式的參數。如果慣用無參數建構函式，則 args 必須是空陣列或 Null。

culture: CultureInfo

特定文化特性的資訊，其可控制 args 到型式類型 (為 typeName 建構函式宣告) 的強制轉型。如果 culture 為 null，會使用目前執行緒的 CultureInfo。

activationAttributes: Object[]

一或多個屬性的陣列，此屬性可參與啟動過程。陣列通常只會包含一個 UrlAttribute 物件來指定用以啟動遠端物件的 URL。

此參數與啟動了用戶端的物件相關。用戶端啟動是一項舊的技術，保留目的在提供回溯相容性，不建議用於新的開發。分散式應用程式應該改用 Windows Communication Foundation。

傳回

Object

要求的物件；當找不到 typeName 時，則為 null。

例外狀況

ArgumentNullException

assemblyName 為 null。

-或-

typeName 為 null。

NotSupportedException

呼叫者無法提供非繼承自 MarshalByRefObject 之物件的啟動屬性。

AppDomainUnloadedException

嘗試對卸載的應用程式定義域執行作業。

FileNotFoundException

找不到 assemblyName。

TypeLoadException

在 assemblyName 中找不到 typeName。

MissingMethodException

找不到相符的公用建構函式。

MethodAccessException

呼叫端沒有足以呼叫這個建構函式的權限。

BadImageFormatException

assemblyName 不是有效的組件。

-或-

用以編譯 assemblyName 的通用語言執行平台，其版本比目前所載入的版本還要更新。

FileLoadException

使用兩個不同的辨識項載入組件或模組兩次。

備註

這是結合 CreateInstanceFrom 和 ObjectHandle.Unwrap的便利方法。

如需這個方法的詳細資訊，請參閱 Activator.CreateInstanceFrom 方法。

另請參閱

CreateInstanceFrom(String, String)

適用於

CreateInstanceFromAndUnwrap(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

警告

Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstanceFromAndUnwrap which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.

建立指定組件檔案中所定義之指定類型的新執行個體。

public:
 System::Object ^ CreateInstanceFromAndUnwrap(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::Security::Policy::Evidence ^ securityAttributes);

public object CreateInstanceFromAndUnwrap (string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes, System.Security.Policy.Evidence securityAttributes);

[System.Obsolete("Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstanceFromAndUnwrap which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public object CreateInstanceFromAndUnwrap (string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes, System.Security.Policy.Evidence securityAttributes);

member this.CreateInstanceFromAndUnwrap : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> obj

[<System.Obsolete("Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstanceFromAndUnwrap which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
member this.CreateInstanceFromAndUnwrap : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> obj

Public Function CreateInstanceFromAndUnwrap (assemblyName As String, typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object(), securityAttributes As Evidence) As Object