Cómo: Crear una directiva de edición

Actualización: noviembre 2007

Los proveedores de ensamblados pueden indicar que las aplicaciones deben usar una versión más reciente de un ensamblado incluyendo un archivo de directivas del editor con el ensamblado actualizado. El archivo de directivas del editor especifica la redirección del ensamblado y la configuración del código base, además de utilizar el mismo formato que un archivo de configuración de la aplicación. El archivo de directivas del editor se compila en un ensamblado y se ubica en la caché de ensamblados global.

El procedimiento para crear una directiva del editor se compone de tres pasos:

1. Cree un archivo de directivas del editor.

2. Cree un ensamblado de directivas del editor.

3. Agregue dicho ensamblado a la caché de ensamblados global.

El esquema de la directiva del editor se describe en Redirigir versiones de ensamblado. En el siguiente ejemplo, se muestra un archivo de directivas del editor que redirige una versión de myAssembly a otra.

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
       <dependentAssembly>
         <assemblyIdentity name="myAssembly"
                           publicKeyToken="32ab4ba45e0a69a1"
                           culture="en-us" />
         <!-- Redirecting to version 2.0.0.0 of the assembly. -->
         <bindingRedirect oldVersion="1.0.0.0"
                          newVersion="2.0.0.0"/>
       </dependentAssembly>
      </assemblyBinding>
   </runtime>
</configuration>

Para saber cómo especificar un código base, vea Especificar una ubicación de ensamblado.

Crear el ensamblado de directivas del editor

Utilice la herramienta Assembly Linker (Al.exe) para crear el ensamblado de directivas del editor.

Para crear un ensamblado de directivas del editor

• Escriba el comando siguiente en el símbolo del sistema:

  **al /link:**Archivo de directivas del editor **/out:**Archivo del ensamblado de directivas del editor **/keyfile:**Archivo de par de claves **/platform:**Arquitectura de procesador

  En este comando:

  • El argumento Archivo de directivas del editor es el nombre del archivo de directivas del editor.

  • El argumento Archivo del ensamblado de directivas del editor es el nombre del ensamblado de directivas del editor que es el resultado de este comando. El nombre de archivo del ensamblado debe tener el siguiente formato:

    policy.Número principal.Número secundario.Nombre de ensamblado principal.dll

  • El argumento Archivo de par de claves es el nombre del archivo que contiene el par de claves. Es necesario firmar el ensamblado y el ensamblado de directivas del editor con el mismo par de claves.

  • El argumento Arquitectura de procesador identifica la plataforma a la que va dirigido un ensamblado específico del procesador. Puede ser amd64, ia64, msil o x86.

    Nota:
    La capacidad de dirigirse a una arquitectura de procesador concreta es nueva en la versión 2.0 de .NET Framework.

  El siguiente comando crea un ensamblado de directivas del editor denominado policy.1.0.myAssembly a partir de un archivo de directivas del editor denominado pub.config, asigna un nombre seguro al ensamblado mediante el par de claves del archivo sgKey.snk y especifica que el ensamblado va dirigido a la arquitectura de procesador x86.

  al /link:pub.config /out:policy.1.0.myAssembly.dll /keyfile:sgKey.snk /platform:x86
  

  El ensamblado de directivas del editor debe coincidir con la arquitectura del procesador del ensamblado al que se aplica. Por tanto, si su ensamblado tiene un valor ProcessorArchitecture de MSIL, el ensamblado de directivas del editor para ese ensamblado se debe crear con /platform:msil. Debe proporcionar un ensamblado de directivas del editor independiente para cada ensamblado específico del procesador.

  Una consecuencia de esta regla es que, para cambiar la arquitectura del procesador para un ensamblado, debe cambiar el componente principal o secundario del número de versión, con el fin de proporcionar un nuevo ensamblado de directivas del editor con la arquitectura del procesador correcta. El ensamblado de directivas del editor anterior no puede reparar el ensamblado cuando éste tiene una arquitectura del procesador diferente.

  Otra consecuencia es que la versión 2.0 del vinculador no se puede utilizar para crear un ensamblado de directivas del editor para un ensamblado compilado mediante versiones anteriores de .NET Framework, porque siempre especifica la arquitectura del procesador.

Agregar el ensamblado de directivas del editor a la caché de ensamblados global

Use la herramienta Caché de ensamblados global (Gacutil.exe) para agregar el ensamblado de directivas del editor a la caché de ensamblados global.

Para agregar el ensamblado de directivas del editor a la caché de ensamblados global

• Escriba el comando siguiente en el símbolo del sistema:

  gacutil /i Archivo de ensamblados del editor

  El siguiente comando agrega policy.1.0.myAssembly.dll a la caché de ensamblados global.

  gacutil /i policy.1.0.myAssembly.dll
  

  Nota importante:
  El ensamblado de directivas del editor no se puede agregar a la caché de ensamblados global a menos que el archivo de directiva del editor original se encuentre en el mismo directorio que el ensamblado.

Vea también

Conceptos

Cómo el motor en tiempo de ejecución ubica ensamblados

Redirigir versiones de ensamblado

Referencia

Esquema de la configuración de Common Language Runtime

Otros recursos

Programar con ensamblados

Archivos de configuración

Configurar aplicaciones

Esquema de los archivos de configuración de .NET Framework