Assembly.LoadFrom 方法

定義

命名空間:

System.Reflection

組件:

System.Runtime.dll

載入組件。

多載

LoadFrom(String, Byte[], AssemblyHashAlgorithm)	指定組件的檔案名稱或路徑，雜湊值和雜湊演算法，來載入組件。
LoadFrom(String)	載入組件，指定其檔案名稱或路徑。

備註

從 .NET Framework 4 開始，預設會停用從遠端位置載入的元件中執行程式代碼的功能，而方法的LoadFrom呼叫會FileLoadException擲回 。 若要載入組件並執行其程式碼，您必須：

• 明確建立元件的沙箱。 (請參閱如何：在 Sandbox.) 中執行部分信任的程序代碼

• 將組態項目的 屬性<loadFromRemoteSources>設定enabled為 true，以完全信任執行元件的程序代碼。 如需詳細資訊，請參閱 <loadFromRemoteSources> 組態專案 一文。

LoadFrom(String, Byte[], AssemblyHashAlgorithm)

來源:

Assembly.cs

指定組件的檔案名稱或路徑，雜湊值和雜湊演算法，來載入組件。

public:
 static System::Reflection::Assembly ^ LoadFrom(System::String ^ assemblyFile, cli::array <System::Byte> ^ hashValue, System::Configuration::Assemblies::AssemblyHashAlgorithm hashAlgorithm);

public static System.Reflection.Assembly LoadFrom (string assemblyFile, byte[]? hashValue, System.Configuration.Assemblies.AssemblyHashAlgorithm hashAlgorithm);

static member LoadFrom : string * byte[] * System.Configuration.Assemblies.AssemblyHashAlgorithm -> System.Reflection.Assembly

Public Shared Function LoadFrom (assemblyFile As String, hashValue As Byte(), hashAlgorithm As AssemblyHashAlgorithm) As Assembly

參數

assemblyFile

String

檔案的名稱或路徑，包含組件的資訊清單。

hashValue

Byte[]

計算的雜湊碼值。

hashAlgorithm

AssemblyHashAlgorithm

雜湊演算法，用於雜湊檔案和用來產生強式名稱 (Strong Name)。

傳回

Assembly

載入的組件。

例外狀況

ArgumentNullException

assemblyFile 為 null。

FileNotFoundException

找不到 assemblyFile，或您想載入的模組並未指定檔案的副檔名。

FileLoadException

無法載入找到的檔案。

-或-

已停用在遠端組件中執行程式碼的能力。 請參閱 <loadFromRemoteSources>。

BadImageFormatException

assemblyFile 不是目前載入運行時間的有效元件;例如，64 位進程中的32位元件。

SecurityException

指定了並非以 "file://" 開頭的程式碼基底，且沒有必要的 WebPermission。

ArgumentException

assemblyFile 參數是空字串 ("")。

PathTooLongException

組件名稱超過系統定義的長度上限。

備註

參數 assemblyFile 必須參考不含逸出字元的 URI。 這個方法會提供 URI 中所有無效字元的逸出字元。

注意

不支援檔案傳輸通訊協定 (FTP) 。 如果提供的 assemblyFile URI 是 FTP 位址，則不會載入元件。 不會擲回任何例外狀況。

assemblyFile 可以是絕對或相對於目前目錄。

元件可以載入三個內容的其中一個，或者可以載入而不載入內容：

• 載入內容包含探查所找到的元件：在全域程式集緩存、裝載運行時間時裝載於主機組件存放區中，或是在應用程式域的和 PrivateBinPath 中ApplicationBase。 Load 方法的大部分多載都會將組件載入此內容中。

• 載入來源內容包含元件，使用者提供未包含在探查中的路徑。 LoadFrom、CreateInstanceFrom 和 ExecuteAssembly 是依路徑載入之方法的範例。

  從 .NET Framework 4 開始，如果的 assemblyFile URI 指定遠端位置，預設會停用元件載入，而且 LoadFrom 方法會擲回 FileLoadException。 若要啟用從遠端位置載入的程式代碼執行，您可以使用組 <loadFromRemoteSources> 態專案。

• 僅限反映的內容包含使用 ReflectionOnlyLoad 和 ReflectionOnlyLoadFrom 方法載入的元件;無法執行這些內容中的程序代碼。

• 如果用戶產生或找到元件，則它不在任何內容中。 這適用於使用 方法的多載載載的 Load 元件，該方法會指定包含元件的位元組數位，以及使用反映發出而未儲存至磁碟的暫時性動態元件。

從內容載入可讓元件從未包含在探查中的路徑載入，並且允許找到並載入該路徑的相依性，因為內容會維護路徑資訊。

方法 LoadFrom 有下列缺點。 請考慮改用 Load。

• 如果已載入具有相同身分識別的組件，LoadFrom 會傳回載入的組件，即使指定不同的路徑也是一樣。

• 如果使用 LoadFrom 載入組件，之後載入內容中的組件卻試圖根據顯示名稱載入相同組件，則載入嘗試會失敗。 還原序列化組件時，也可能發生這種情況。

• 如果使用 載入 LoadFrom元件，而且探查路徑包含具有相同身分識別但不同位置 InvalidCastException、、 MissingMethodException或其他非預期行為的元件。

• LoadFrom 要求所指定路徑上的 FileIOPermissionAccess.Read 和 FileIOPermissionAccess.PathDiscovery 或 WebPermission。

• 如果 的 assemblyFile原生映射存在，則不會使用它。 組件無法以定義域中性方式載入。

元件會以載入器所提供的辨識項載入。

LoadFrom(String)

來源:

Assembly.cs

載入組件，指定其檔案名稱或路徑。

public:
 static System::Reflection::Assembly ^ LoadFrom(System::String ^ assemblyFile);

public static System.Reflection.Assembly LoadFrom (string assemblyFile);

static member LoadFrom : string -> System.Reflection.Assembly

Public Shared Function LoadFrom (assemblyFile As String) As Assembly

參數

assemblyFile

String

檔案的名稱或路徑，包含組件的資訊清單。

傳回

Assembly

載入的組件。

例外狀況

ArgumentNullException

assemblyFile 為 null。

FileNotFoundException

找不到assemblyFile ，或您想載入的模組並未指定檔案的副檔名。

FileLoadException

無法載入找到的檔案。

-或-

已停用在遠端組件中執行程式碼的能力。 請參閱 <loadFromRemoteSources>。

BadImageFormatException

assemblyFile 不是目前載入運行時間的有效元件;例如，64 位進程中的32位元件。

SecurityException

指定了並非以 "file://" 開頭的程式碼基底，且沒有必要的 WebPermission。

ArgumentException

assemblyFile 參數是空字串 ("")。

PathTooLongException

組件名稱超過系統定義的長度上限。

範例

下列範例會載入指定其檔名或路徑的元件。

Assembly^ SampleAssembly;
SampleAssembly = Assembly::LoadFrom( "c:\\Sample.Assembly.dll" );
// Obtain a reference to a method known to exist in assembly.
MethodInfo^ Method = SampleAssembly->GetTypes()[ 0 ]->GetMethod( "Method1" );
// Obtain a reference to the parameters collection of the MethodInfo instance.
array<ParameterInfo^>^ Params = Method->GetParameters();
// Display information about method parameters.
// Param = sParam1
//   Type = System::String
//   Position = 0
//   Optional=False
for each ( ParameterInfo^ Param in Params )
{
   Console::WriteLine( "Param= {0}", Param->Name );
   Console::WriteLine( "  Type= {0}", Param->ParameterType );
   Console::WriteLine( "  Position= {0}", Param->Position );
   Console::WriteLine( "  Optional= {0}", Param->IsOptional );
}

Assembly SampleAssembly;
SampleAssembly = Assembly.LoadFrom("c:\\Sample.Assembly.dll");
// Obtain a reference to a method known to exist in assembly.
MethodInfo Method = SampleAssembly.GetTypes()[0].GetMethod("Method1");
// Obtain a reference to the parameters collection of the MethodInfo instance.
ParameterInfo[] Params = Method.GetParameters();
// Display information about method parameters.
// Param = sParam1
//   Type = System.String
//   Position = 0
//   Optional=False
foreach (ParameterInfo Param in Params)
{
    Console.WriteLine("Param=" + Param.Name.ToString());
    Console.WriteLine("  Type=" + Param.ParameterType.ToString());
    Console.WriteLine("  Position=" + Param.Position.ToString());
    Console.WriteLine("  Optional=" + Param.IsOptional.ToString());
}

Dim SampleAssembly As [Assembly]
SampleAssembly = [Assembly].LoadFrom("c:\Sample.Assembly.dll")
' Obtain a reference to a method known to exist in assembly.
Dim Method As MethodInfo = SampleAssembly.GetTypes()(0).GetMethod("Method1")
' Obtain a reference to the parameters collection of the MethodInfo instance.
Dim Params As ParameterInfo() = Method.GetParameters()
' Display information about method parameters.
' Param = sParam1
'   Type = System.String
'   Position = 0
'   Optional=False
For Each Param As ParameterInfo In Params
    Console.WriteLine(("Param=" + Param.Name.ToString()))
    Console.WriteLine(("  Type=" + Param.ParameterType.ToString()))
    Console.WriteLine(("  Position=" + Param.Position.ToString()))
    Console.WriteLine(("  Optional=" + Param.IsOptional.ToString()))
Next

備註

參數 assemblyFile 必須參考不含逸出字元的 URI。 這個方法會提供 URI 中所有無效字元的逸出字元。

注意

不支援檔案傳輸通訊協定 (FTP) 。 如果提供的 assemblyFile URI 是 FTP 位址，則不會載入元件。 不會擲回任何例外狀況。

assemblyFile 可以是絕對或相對於目前目錄。

元件可以載入三個內容的其中一個，或者可以載入而不載入內容：

• 載入內容包含探查所找到的元件：在 GAC 中、裝載運行時間時位於主機組件存放區中，或是在應用程式域的 和 PrivateBinPath 中ApplicationBase。 Load 方法的大部分多載都會將組件載入此內容中。

• 載入來源內容包含元件，使用者提供未包含在探查所搜尋之目錄中的路徑。 LoadFrom、CreateInstanceFrom 和 ExecuteAssembly 是依路徑載入之方法的範例。

  從 .NET Framework 4 開始，如果的 assemblyFile URI 指定遠端位置，預設會停用元件載入，而且 LoadFrom 方法會FileLoadException擲回 。 若要啟用從遠端位置載入的程式代碼執行，您可以使用組 <loadFromRemoteSources> 態專案。

• 僅限反映的內容包含使用 ReflectionOnlyLoad 和 ReflectionOnlyLoadFrom 方法載入的元件;無法執行這些內容中的程序代碼。

• 如果用戶產生或找到元件，則它不在任何內容中。 這適用於使用 方法的多載載載的 Load 元件，該方法會指定包含元件的位元組數位，以及使用反映發出而未儲存至磁碟的暫時性動態元件。

從內容載入可讓元件從探查中未包含的路徑載入，並且允許找到並載入該路徑的相依性，因為路徑資訊是由內容維護。

方法 LoadFrom 有下列缺點。 請考慮改用 Load。

• 如果已在載入來源中載入具有相同身分識別的組件，LoadFrom 會傳回載入的組件，即使已指定不同的路徑亦然。

• 即使載入內容中存在具有相同身分識別的元件，也可以載入從內容載入元件。 這兩個元件之間的互操作性無法運作，導致發生錯誤，例如 InvalidCastException、 MissingMethodException或其他非預期的行為。

• 使用探查路徑中的位置呼叫 LoadFrom ，將會在載入內容中載入元件，而不是載入來源內容中的元件。

• 如果系結重新導向原則傳遞其身分識別的元件檔案會傳遞至 LoadFrom，則會套用原則，並從載入內容中的探查路徑載入元件。

• 如果在載入來源內容中載入元件，而載入內容中的元件稍後會嘗試依顯示名稱載入相同的元件，則載入嘗試會失敗。 還原序列化組件時，也可能發生這種情況。

• LoadFrom 要求所指定路徑上的 FileIOPermissionAccess.Read 和 FileIOPermissionAccess.PathDiscovery 或 WebPermission。

• 如果 的 assemblyFile原生映射存在，則不會使用它。 元件無法載入為網域中性。