<CodeBase Element (Elemento codeBase> )

Artigo
05/09/2023

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>

Partilhar via