Compartilhar via


/linkresource (opções do compilador C#)

Cria um link para um recurso do .NET Framework no arquivo de saída. O arquivo de recursos que não é adicionado ao arquivo de saída. Isso difere da opção de /resource que insere um arquivo de recursos no arquivo de saída.

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

Arguments

  • filename
    O arquivo de recursos do .NET Framework à qual você deseja vincular do assembly.

  • identifier (opcional)
    O nome lógico do recurso; o nome usado para carregar o recurso. O padrão é o nome do arquivo.

  • accessibility-modifier (opcional)
    A facilidade de uso de recursos: público ou particular. A opção é pública.

Comentários

Por padrão, os recursos vinculados são públicos no assembly quando são criados com o compilador C#. Para tornar os recursos privados, especifique private como o modificador de acessibilidade. É permitido em qualquer outro modificador a não ser public ou private .

/linkresource exige uma das opções de /target diferentes de /target:module.

Se filename é um arquivo de recursos do .NET Framework criado, por exemplo, por Resgen.exe ou no ambiente de desenvolvimento, pode ser acessado com membros do namespace System.Resources . Para obter mais informações, consulte ResourceManager. Para todos recursos demais, use GetManifestResource* métodos na classe de Assembly para acessar em tempo de execução do recurso.

O arquivo especificado em filename pode ser qualquer formato. Por exemplo, talvez você queira fazer parte de DLL nativa do assembly, de modo que possa ser instalado em cachê de assembly global e ser acessado de código gerenciado no assembly. O segundo nos exemplos a seguir mostra como fazer isso. Você pode fazer a mesma coisa no vinculador do assembly. O terceiro dos exemplos a seguir mostra como fazer isso. Para obter mais informações, consulte Al.exe (Assembly Linker) e Trabalhando com assemblies e o cache de assemblies global.

/linkres é a forma abreviada de /linkresource.

Essa opção do compilador não estiver disponível no Visual Studio e não pode ser modificada programaticamente.

Exemplo

Criar in.cs e links no arquivo de recurso rf.resource:

csc /linkresource:rf.resource in.cs

Criar A.cs em uma DLL, um link a DLL nativa N.dll, e coloca a saída em cachê de assembly global (GAC). Neste exemplo, A.dll e N.dll irão residir no GAC.

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

Este exemplo faz a mesma coisa que anterior, mas usando opções do vinculador do assembly.

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

Consulte também

Tarefas

Como modificar as propriedades de projeto e as definições de configuração

Referência

Al.exe (Assembly Linker)

Outros recursos

Opções do compilador de C#

Trabalhando com assemblies e o cache de assemblies global