<CodeBase Element (Elemento codeBase> )

  • Artigo

Especifica onde o runtime de linguagem comum pode encontrar uma assemblagem.

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

Syntax

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

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo Descrição
href Atributo obrigatório.

Especifica o URL onde o runtime pode encontrar a versão especificada da assemblagem.
version Atributo obrigatório.

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

atributo de versão

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

Elementos Subordinados

Nenhum.

Elementos Principais

Elemento Descrição
buildproviders Define uma coleção de fornecedores de compilação utilizados para compilar ficheiros de recursos personalizados. Pode ter qualquer número de fornecedores de compilação.
compilation Configura todas as definições de compilação que ASP.NET utiliza.
configuration O elemento raiz em cada ficheiro de configuração utilizado pelo runtime de linguagem comum e .NET Framework aplicações.
System.web Especifica o elemento raiz para a secção de configuração ASP.NET.

Observações

Para que o runtime utilize a <definição codeBase> num ficheiro de configuração do computador ou ficheiro de política do publicador, o ficheiro também tem de redirecionar a versão de assemblagem. Os ficheiros de configuração da aplicação podem ter uma definição de código base sem redirecionar a versão de assemblagem. Depois de determinar qual a versão de assemblagem a utilizar, o runtime aplica a definição codebase do ficheiro que determina a versão. Se não for indicada nenhuma base de código, o runtime sonda a assemblagem da forma habitual.

Se a assemblagem tiver um nome forte, a definição de base de código pode estar em qualquer parte da intranet local ou da Internet. Se a assemblagem for uma assemblagem privada, a definição de base de código tem de ser um caminho relativo ao diretório da aplicação.

Para assemblagens sem um nome forte, a versão é ignorada e o carregador utiliza o primeiro aspeto do codebase> dentro <de <dependentAssembly>. Se existir uma entrada no ficheiro de configuração da aplicação que redireciona o enlace para outra assemblagem, o redirecionamento terá precedência mesmo que a versão de assemblagem não corresponda ao pedido de enlace.

Exemplo

O exemplo seguinte mostra como especificar onde o runtime pode encontrar uma assemblagem.

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

Ver também