/linkresource (Vincular a recursos de .NET Framework) (Opciones del compilador de C#)

Actualización: noviembre 2007

Crea un vínculo con un recurso de .NET Framework en el archivo de salida. El archivo de recursos no se agrega al archivo de resultados. Esta opción difiere de la opción /resource, la cual sí incrusta un archivo de recursos en el archivo de resultados.

/linkresource:filename[,identifier[,accessibility-modifier]]

Argumentos

  • filename
    Archivo de recursos de .NET Framework con el que desea crear un vínculo desde el ensamblado.

  • identifier (opcional)
    Nombre lógico del recurso; nombre que se usa para cargar el recurso. El valor predeterminado es el nombre del archivo.

  • accessibility-modifier (opcional)
    Accesibilidad del recurso: pública o privada. El valor predeterminado es que sea pública.

Comentarios

De forma predeterminada, los recursos vinculados son públicos en el ensamblado cuando se crean con el compilador de C#. Para que sean privados, especifique el modificador de accesibilidad private. No se permite ningún otro modificador distinto de public o private.

/linkresource requiere una de las opciones de /target distinta de /target:module.

Si filename es un archivo de recursos de .NET Framework creado, por ejemplo, con Resgen.exe o en el entorno de desarrollo, se puede obtener acceso a él con miembros del espacio de nombres System.Resources. Para obtener más información, vea System.Resources.ResourceManager. Para todos los demás recursos, utilice los métodos GetManifestResource* de la clase Assembly para obtener acceso al recurso en tiempo de ejecución.

El archivo especificado en filename puede tener cualquier formato. Por ejemplo, se puede hacer que una DLL nativa forme parte de un ensamblado para que se pueda instalar en la caché de ensamblados global y sea accesible desde código administrado del ensamblado. El segundo de los siguientes ejemplos muestra cómo hacerlo. También es posible llevarlo a cabo en Assembly Linker. El tercer ejemplo indica cómo. Para obtener más información, vea Herramienta Assembly Linker (Al.exe) y Trabajar con ensamblados y la memoria Caché de ensamblados global.

/linkres es la forma abreviada de /linkresource.

Esta opción del compilador no está disponible en Visual Studio y no se puede cambiar mediante programación.

Ejemplo

Para compilar in.cs y vincularlo al archivo de recursos rf.resource, ejecute:

csc /linkresource:rf.resource in.cs

Para compilar A.cs en un archivo DLL, vincularlo a un archivo DLL nativo N.dll y colocar el resultado en la Caché de ensamblados global (GAC), ejecute lo siguiente. En este ejemplo, A.dll y N.dll residen en la GAC.

csc /linkresource:N.dll /t:library A.cs
gacutil -i A.dll

Este ejemplo hace lo mismo que el anterior, pero utiliza las opciones de Assembly Linker.

csc /t:module A.cs
al /out:A.dll A.netmodule /link:N.dll 
gacutil -i A.dll

Vea también

Referencia

Herramienta Assembly Linker (Al.exe)

Otros recursos

Opciones del compilador de C#

Trabajar con ensamblados y la memoria Caché de ensamblados global

Propiedades del proyecto (Visual Studio)