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。

此參數與客戶端啟動的物件相關。用戶端啟用是保留的舊版技術，可保持回溯相容性，但不建議用於新的開發。分散式應用程式應該改用 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

針對 typeName 建構函式所宣告之 args 強制型別的文化特性特定資訊。如果 culturenull，則會使用目前線程的 CultureInfo。

activationAttributes: Object[]

一或多個可以參與啟用的屬性陣列。一般而言，包含單一 UrlAttribute 對象的陣列，指定啟動遠端物件所需的URL。

傳回

Object

如果找不到 typeName，則為要求的物件，或 null。

例外狀況

ArgumentNullException

assemblyFile null。

-或-

typeName null。

NotSupportedException

呼叫端無法為未繼承自 MarshalByRefObject的物件提供啟用屬性。

AppDomainUnloadedException

在卸除的應用程式域上嘗試作業。

FileNotFoundException

找不到 assemblyFile。

TypeLoadException

assemblyFile中找不到 typeName。

MissingMethodException

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

MethodAccessException

呼叫端沒有足夠的許可權可呼叫這個建構函式。

BadImageFormatException

assemblyFile 不是有效的元件。

-或-

assemblyFile 是以目前載入版本之較新版本的 Common Language Runtime 編譯。

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