<qualifyAssembly> 項目

  • 發行項

指定組件的完整名稱，使用部分名稱時，應以動態方式載入這個名稱。

<configuration> 項目
  <runtime> 項目
    <assemblyBinding> 項目
      <qualifyAssembly> 項目

<qualifyAssembly partialName="PartialAssemblyName"
                                  fullName="FullAssemblyName"/>

屬性和項目

下列小節描述屬性、子項目和父項目。

屬性

屬性 說明

partialName

必要屬性。

指定出現在程式碼中的組件部分名稱。

fullName

必要屬性。

指定出現在全域組件快取中的組件完整名稱。

子項目

無

父項目

項目 說明

assemblyBinding

包含有關組件版本重新導向和組件位置的資訊。

configuration

每一個組態檔中的根 (Root) 項目是由 Common Language Runtime 和 .NET Framework 應用程式所使用的。

runtime

包含有關組件繫結和記憶體回收的資訊。

備註

使用部分組件名稱來呼叫 Assembly.Load 方法，這會使 Common Language Runtime 只在應用程式基底目錄中尋找組件。使用應用程式組態檔中的 <qualifyAssembly> 項目來提供完整的組件資訊 (名稱、版本、公開金鑰語彙基元和文化特性)，並使 Common Language Runtime 在全域組件快取中搜尋組件。

fullName 屬性必須包含組件識別 (Identity) 的四個欄位：名稱、版本、公開金鑰語彙基元和文化特性 (Culture)。partialName 屬性必須部分參考組件。您至少必須指定組件的文字名稱 (最常見的情況)，但是您也可以包含版本、公開金鑰語彙基元或文化特性 (或是這四個欄位的任意組合，但是並非全部四個欄位)。partialName 必須符合在呼叫中指定的名稱。例如，您不可以在組態檔中將 "math" 指定為 partialName 屬性，然後在程式碼中呼叫 Assembly.Load("math, Version=3.3.3.3")。

範例

下列範例以邏輯方式將呼叫 Assembly.Load("math") 變成 Assembly.Load("math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral")。

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <qualifyAssembly partialName="math" 
                         fullName=
"math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral"/>
      </assemblyBinding>
   </runtime>
</configuration>

請參閱

參考

執行階段設定結構描述

概念

執行階段如何找出組件
部分組件參考