Opções do compilador C# que especificam recursos

As opções a seguir controlam como o compilador C# cria ou importa recursos do Win32. A nova sintaxe do MSBuild é mostrada em negrito. A sintaxe csc.exe mais antiga

• Win32Resource / -win32res: Especifique um arquivo de recurso Win32 (.res).
• Win32Icon / -win32icon: metadados de referência do arquivo ou arquivos de assembly especificados.
• Win32Manifest / -win32manifest: Especifique um arquivo de manifesto do Win32 (.xml).
• NoWin32Manifest / -nowin32manifest: Não inclua o manifesto Win32 padrão.
• EmbeddedResource / -resource: Incorporar o recurso especificado (Forma abreviada: /res).
• LinkResource / -linkresource: Liga o recurso especificado a esta assembleia.

Win32Recurso

A opção Win32Resource insere um recurso Win32 no arquivo de saída.

<Win32Resource>filename</Win32Resource>

filename é o arquivo de recurso que você deseja adicionar ao arquivo de saída. Um recurso Win32 pode conter informação de versão ou bitmap (ícone) que ajuda a identificar a sua aplicação no Explorador de Ficheiros. Se não especificar esta opção, o compilador gera informação de versão com base na versão assembly.

Win32Icon

A opção Win32Icon insere um ficheiro .ico no ficheiro de saída, o que dá ao ficheiro de saída a aparência desejada no Explorador de Ficheiros.

<Win32Icon>filename</Win32Icon>

filename é o arquivo de .ico que você deseja adicionar ao arquivo de saída. Pode criar um ficheiro .ico usando o Compilador de Recursos. O Compilador de Recursos é invocado quando compilas um programa Visual C++. Um ficheiro .ico é criado a partir do ficheiro .rc .

Win32Manifest

Use a opção Win32Manifest para especificar um ficheiro de manifesto de aplicação Win32 definido pelo utilizador para ser incorporado no ficheiro executável portátil (PE) de um projeto.

<Win32Manifest>filename</Win32Manifest>

filename é o nome e o local do arquivo de manifesto personalizado. Por defeito, o compilador C# incorpora um manifesto de aplicação que especifica um nível de execução solicitado de asInvoker. Cria o manifesto na mesma pasta onde o executável é construído. Se quiser fornecer um manifesto personalizado, por exemplo para especificar um nível de execução solicitado de highestAvailable ou requireAdministrator, use esta opção para especificar o nome do ficheiro.

Uma aplicação que não tem manifesto de aplicação que especifique um nível de execução solicitado está sujeita à virtualização de ficheiros e registos sob a funcionalidade de Controlo de Conta de Utilizador no Windows. Para obter mais informações, consulte Controle de conta de usuário.

A sua aplicação está sujeita a virtualização se alguma destas condições for verdadeira:

• Você usa a opção NoWin32Manifest e não fornece um manifesto em uma etapa de compilação posterior ou como parte de um arquivo de recurso do Windows (.res) usando a opção Win32Resource.
• Você fornece um manifesto personalizado que não especifica um nível de execução solicitado.

O Visual Studio cria um arquivo .manifest padrão e o armazena nos diretórios de depuração e liberação ao lado do arquivo executável. Você pode adicionar um manifesto personalizado criando um em qualquer editor de texto e, em seguida, adicionando o arquivo ao projeto. Ou, você pode clicar com o botão direito do mouse no ícone Projeto no Gerenciador de Soluções, selecionar Adicionar Novo Item e, em seguida, selecionar Arquivo de Manifesto do Aplicativo. Depois de adicionar o seu ficheiro de manifesto novo ou existente, ele aparece na lista suspensa do Manifesto . Para obter mais informações, consulte Página de aplicativo, Project Designer (C#).

Você pode fornecer o manifesto do aplicativo como uma etapa pós-compilação personalizada ou como parte de um arquivo de recurso Win32 usando a opção NoWin32Manifest . Use essa mesma opção se quiser que seu aplicativo esteja sujeito à virtualização de arquivo ou registro no Windows Vista.

NoWin32Manifest

Use a opção NoWin32Manifest para instruir o compilador a não incorporar nenhum manifesto do aplicativo no arquivo executável.

<NoWin32Manifest />

Quando utiliza esta opção, a aplicação está sujeita a virtualização no Windows Vista, a menos que forneça um manifesto de aplicação num ficheiro de Recurso Win32 ou durante uma etapa de compilação posterior.

No Visual Studio, defina essa opção na página Propriedade do aplicativo selecionando a opção Criar aplicativo sem manifesto na lista suspensa Manifesto. Para obter mais informações, consulte Página de aplicativo, Project Designer (C#).

EmbeddedResource

Incorpora o recurso especificado no arquivo de saída.

<EmbeddedResource Include="filename">
  <LogicalName>identifier</LogicalName>
  <Access>accessibility-modifier</Access>
</EmbeddedResource>

filename é o arquivo de recurso .NET que você deseja incorporar no arquivo de saída. identifier (opcional) é o nome lógico do recurso: o nome que usa para carregar o recurso. O padrão é o nome do arquivo. accessibility-modifier (opcional) é a acessibilidade do recurso: público ou privado. O padrão é público. Por defeito, os recursos são públicos na assembly quando os crias usando o compilador C#. Para tornar os recursos privados, especifique private como o modificador de acessibilidade. Não é permitida outra acessibilidade. Se filename for um ficheiro de recurso .NET criado, por exemplo, por Resgen.exe ou no ambiente de desenvolvimento, pode aceder a ele usando membros no espaço de nomes System.Resources. Para obter mais informações, veja System.Resources.ResourceManager. Para todos os outros recursos, use os GetManifestResourceAssembly métodos na classe para acessar o recurso em tempo de execução. A ordem dos recursos no ficheiro de saída vem da ordem especificada no ficheiro do projeto.

LinkResource

Cria um link para um recurso .NET no arquivo de saída. O arquivo de recurso não é adicionado ao arquivo de saída. LinkResource difere da opção EmbeddedResource , que incorpora um ficheiro de recurso no ficheiro de saída.

<LinkResource Include="filename">
  <LogicalName>identifier</LogicalName>
  <Access>accessibility-modifier</Access>
</LinkResource>

filename é o arquivo de recurso .NET ao qual você deseja vincular a partir do assembly. identifier (opcional) é o nome lógico do recurso: o nome que usa para carregar o recurso. O padrão é o nome do arquivo. accessibility-modifier (opcional) é a acessibilidade do recurso: público ou privado. O padrão é público. Por defeito, os recursos ligados são públicos na assembly quando os crias usando o compilador C#. Para tornar os recursos privados, especifique private como o modificador de acessibilidade. Não é permitido outro modificador. Se filename for um ficheiro de recurso .NET criado, por exemplo, por Resgen.exe ou no ambiente de desenvolvimento, pode aceder a ele usando membros no espaço de nomes System.Resources. Para obter mais informações, veja System.Resources.ResourceManager. Para todos os outros recursos, use os GetManifestResourceAssembly métodos na classe para acessar o recurso em tempo de execução. O arquivo especificado em filename pode ser qualquer formato. Por exemplo, pode querer tornar uma DLL nativa parte do assembly, para que possa ser instalada na cache assembly global e acedida a partir do código gerido no assembly. Você pode fazer a mesma coisa no Assembly Linker. Para obter mais informações, consulte Al.exe (Assembly Linker) e Working with Assemblies and the Global Assembly Cache.