<qualifyAssembly> 元素

  • 發行項

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

<configuration>
  <runtime>
    <assemblyBinding>
      <qualifyAssembly>

Syntax

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

屬性和項目

下列章節說明屬性、子元素和父元素。

屬性

屬性 描述
partialName 必要屬性。

指定組件在程式碼中顯示的部分名稱。
fullName 必要屬性。

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

子元素

無。

父項目

元素 描述
assemblyBinding 包含有關組件版本重新導向和組件位置的資訊。
configuration 通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
runtime 包含有關組件繫結和記憶體回收的資訊。

備註

使用部分組件名稱呼叫 Assembly.Load 方法會導致通用語言執行階段只在應用程式基底目錄中尋找組件。 在您的應用程式組態檔中使用 <qualifyAssembly> 元素來提供完整的組件資訊 (名稱、版本、公開金鑰語彙基元和文化特性)，並且讓通用語言執行階段在全域組件快取中搜尋組件。

fullName 屬性必須包含組件身分識別的四個欄位：名稱、版本、公開金鑰權杖和文化特性。 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>

另請參閱