<codeBase> 要素

  • [アーティクル]

共通言語ランタイムがアセンブリを検索できる場所を指定します。

configuration
  runtime
    <assemblyBinding>
      <dependentAssembly>
        <codeBase>

構文

   <codeBase
        version="Assembly version"
        href="URL of assembly"/>

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性 説明
href 必須の属性です。

ランタイムが指定されたバージョンのアセンブリを検索できる URL を指定します。
version 必須の属性です。

コードベースが適用されるアセンブリのバージョンを指定します。 アセンブリ バージョン番号の形式は "メジャー.マイナー.ビルド.リビジョン" です。

version 属性

[値] 説明
このバージョン番号の各部分で有効値は、0 ～ 65535 です。 適用不可。

子要素

なし。

親要素

要素 説明
buildproviders カスタム リソース ファイルをコンパイルするためのビルド プロバイダーのコレクションを定義します。 ビルド プロバイダーの数は任意です。
compilation ASP.NET で使用されるすべてのコンパイル設定を構成します。
configuration 共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。
System.web ASP.NET 構成セクションのルート要素を指定します。

解説

ランタイムでマシン構成ファイルまたは発行者ポリシー ファイルの <codeBase> 設定を使用するには、そのファイルでもアセンブリのバージョンをリダイレクトする必要があります。 アプリケーション構成ファイルには、アセンブリのバージョンをリダイレクトせずにコードベースを設定できます。 使用するアセンブリのバージョンを決定した後、ランタイムでは、バージョンを決定するファイルのコードベース設定が適用されます。 コードベースが指定されていない場合、ランタイムでは通常の方法でアセンブリをプローブします。

アセンブリに厳密な名前が付いている場合、コードベースの設定は、ローカル イントラネットまたはインターネット上の任意の場所に置くことができます。 アセンブリがプライベート アセンブリの場合、コードベースの設定は、アプリケーションのディレクトリに対する相対パスである必要があります。

厳密な名前のないアセンブリの場合、バージョンは無視され、ローダーでは <dependentAssembly> 内部の最初の <codebase> が使用されます。 バインドを別のアセンブリにリダイレクトするエントリがアプリケーション構成ファイルにある場合は、アセンブリのバージョンがバインディング要求と一致しなくても、リダイレクトが優先されます。

例

次の例では、ランタイムがアセンブリを検索できる場所を指定する方法を示します。

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <dependentAssembly>
            <assemblyIdentity name="myAssembly"
                              publicKeyToken="32ab4ba45e0a69a1"
                              culture="neutral" />
            <codeBase version="2.0.0.0"
                      href="http://www.litwareinc.com/myAssembly.dll"/>
         </dependentAssembly>
      </assemblyBinding>
   </runtime>
</configuration>

関連項目