Elemento <codeBase>

  • Artigo

Especifica onde o common language runtime pode encontrar um assembly.

<configuração>
  <runtime>
    <assemblyBinding>
      <dependentAssembly>
        <codeBase>

Syntax

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo Descrição
href Atributo obrigatório.

Especifica a URL em que o runtime pode encontrar a versão especificada do assembly.
version Atributo obrigatório.

Especifica a versão do assembly à qual a base de código se aplica. O formato de um número de versão do assembly é major.minor.build.revision.

Atributo de versão

Valor Descrição
Os valores válidos para cada parte do número de versão estão entre 0 e 65535. Não aplicável.

Elementos filho

Nenhum.

Elementos pai

Elemento Descrição
buildproviders Define uma coleção de provedores de build usados para compilar arquivos de recursos personalizados. Você pode ter qualquer número provedores de build.
compilation Configura todas as configurações de compilação que o ASP.NET usa.
configuration O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.
System.web Especifica o elemento raiz da seção de configuração do ASP.NET.

Comentários

Para que o runtime use a configuração <codeBase> em um arquivo de configuração do computador ou arquivo de política do editor, o arquivo também deve redirecionar a versão do assembly. Os arquivos de configuração do aplicativo podem ter uma configuração de base de código sem redirecionar a versão do assembly. Depois de determinar qual versão de assembly usar, o runtime aplica a configuração de base de código do arquivo que determina a versão. Se não for indicada nenhuma base de código, o runtime investigará o assembly da maneira usual.

Se o assembly tiver um nome forte, a configuração da base de código poderá estar em qualquer lugar na intranet local ou na Internet. Se o assembly for um assembly privado, a configuração da base de código deverá ser um caminho relativo ao diretório do aplicativo.

Para assemblies sem um nome forte, a versão é ignorada e o carregador usa a primeira aparência de >base de código< no <dependentAssembly>. Se houver uma entrada no arquivo de configuração do aplicativo que redirecione a associação a outro assembly, o redirecionamento terá precedência mesmo se a versão do assembly não corresponder à solicitação de associação.

Exemplo

O exemplo a seguir mostra como especificar onde o runtime pode encontrar um assembly.

<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>

Confira também