Propriedades de arquivo
Você pode usar propriedades de arquivo para indicar quais ações o sistema do projeto deve executar nos arquivos.Por exemplo, você pode definir propriedades de arquivo para indicar se um arquivo deve ser compilado ou inserido na saída da compilação como um recurso
Você pode selecionar qualquer arquivo no Solution Explorer e depois examinar suas propriedades na janela Properties.Arquivos Visual Basic e C# Visual têm quatro propriedades: Nome do arquivo, Build Action, Ferramenta personalizada, e Custom Tool Namespace.
.gif "Observação") Observação |
|---|
O Build Action, Ferramenta personalizada, e Custom Tool Namespace propriedades são fornecidas para cenários avançados.Os valores padrão são normalmente suficientes e não precisam ser alterados. |
Propriedade de nome de arquivo
Você pode renomear um arquivo clicando no Nome do arquivo propriedade na janela Properties e digitando o novo nome.Observe que se você alterar o nome do arquivo, o Visual Studio automaticamente renomeará qualquer arquivo .vb ou .resx associados a ele.
Criar a propriedade Action
O Build Action propriedade indica o que Visual Studio faz com que um arquivo, quando uma compilação é executada.Ação de compilação pode ter um dos vários valores:
None - O arquivo é não incluído na grupo de saída do projeto e não é compilado no processo de criação.Um exemplo é um arquivo de texto que contém a documentação, assim como um arquivo leiame.
Compile - O arquivo é compilado para a criação de saída.Esta configuração é usada para arquivos de código.
Content - O arquivo não é compilado, mas está incluído no grupo de conteúdo de saída.Por exemplo, essa configuração é o valor padrão para um .htm ou outro tipo de arquivo da Web.
Embedded Resource - Este arquivo está inserido na saída principal compilação do projeto como uma DLL ou executável.Ele é normalmente usado para os arquivos de recurso.
ObservaçãoO Build Action propriedade é extensível.Como resultado, você pode ver as opções adicionais listadas para esta propriedade que foram adicionadas por outros produtos e recursos.
O valor padrão para Build Action depende da extensão do arquivo que você adiciona à solução.Por exemplo, se você adicionar um Visual Basic o projeto ao Solution Explorer, o valor padrão para Build Action é Compilar.Isso ocorre porque a extensão .vb indica um arquivo de código que pode ser compilado.Nomes e extensões de arquivos aparecem no Solution Explorer.
Observe que o nome do arquivo no seu projeto não será o identificador para o recurso gerenciado no manifesto do assembly (consulte Manifesto do assembly para obter mais informações).O identificador será namespace.filename.extension, onde namespace é o valor da DefaultNamespace propriedade em um projeto do Visual C# ou RootNamespace propriedade em um Visual Basic projeto.Nomearquivo e extensão permanecem os mesmos que suas designações originais.Se o arquivo for um arquivo .resx, o sistema do projeto executará resgen.exe no arquivo, criando um arquivo .resource.O arquivo .resource será inserido no assembly.Portanto, o manifesto do assembly fará referência para o arquivo .resources e não o arquivo .RESX.
Por exemplo, se você adicionar o arquivo MeuArquivo.bmp a um projeto cujo namespace padrão é MeuProjeto e definir a ação de compilação como Embedded Resource, MeuProjeto.MeuArquivo.bmp será o identificador no manifesto do assembly.Se você depois adicionar o arquivo MyFile.resx ao projeto, a ação de compilação padrão será Embedded Resource, e MyProj.MyFile.resources será o identificador no manifesto do assembly.
Observe que, quando o editor de recursos adiciona uma imagem, ele configura Build Action como None, porque o arquivo .resx referencia o arquivo de imagem.Em tempo de compilação, a imagem é colocada no arquivo .resources criado a partir do arquivo .resx.A imagem pode depois ser facilmente acessada através da classe fortemente tipada auto-gerada para o arquivo .resx.Portanto, você não deve alterar esta configuração para Embedded Resource porque isso incluirá a imagem duas vezes no assembly.
Para obter mais informações sobre como acessar arquivos de recurso (compilados a partir de arquivos. resx) em tempo de execução, consulte ResourceManager.Para obter mais informações sobre como acessar todos os outros incorporados a arquivos e recursos em tempo de execução, consulte GetManifestResourceStream.
Copiar para a propriedade de diretório de saída
Esta propriedade especifica as condições sob as quais o arquivo de origem selecionado será copiado para a pasta de saída.Selecione Não copiar se o arquivo nunca deva ser copiado para o diretório de saída.Selecione Sempre copiar se o arquivo sempre deva ser copiado para o diretório de saída.Selecione Copiar se mais recente se o arquivo deva ser copiado somente quando ele for mais recente que um arquivo existente de mesmo nome no diretório de saída.
Para obter informações sobre como alterar o diretório de saída, consulte Compilação de página, Designer de projeto (C#) ou Compilar página Project Designer (Visual Basic).
| Observação |
|---|
Em projetos de dispositivo inteligente, a renovação de um arquivo .dll ou .exe é determinada comparando as versões Win32 da seguinte maneira: Se a versão do lado do dispositivo for menor do que a da área de trabalho, o arquivo é copiado. Se a versão do lado do dispositivo for maior do que a da área de trabalho, o arquivo não é copiado. Se as versões forem iguais, uma comparação de soma de verificação é feita.Se as somas de verificação forem iguais, o arquivo não é copiado.Se as somas de verificação forem diferentes, o arquivo é copiado. A renovação dos arquivos diferentes de .dll e .exe é baseada somente em soma de verificação. |
| Observação |
|---|
Arquivos de dados serão copiados para uma subpasta chamada Arquivos de dados no diretório de saída. |
Propriedade personalizada da ferramenta
Ferramentas personalizadas são componentes que podem ser usados para transformar arquivos de um tipo em outro em tempo de design.Por exemplo, uma ferramenta personalizada pode ser um gerador de código de DataSet que lê um arquivo de esquema XML (.xsd) como entrada, e gera classes em um arquivo de código que programaticamente expõem suas tabelas e colunas.Existe uma lista pré-definida de ferramentas personalizadas disponíveis no produto; esta propriedade permite que você veja qual ferramenta personalizada é aplicada a um arquivo.Em raras circunstâncias, pode ser necessário que você altere o valor dessa propriedade.O valor desta propriedade deve estar em branco ou ser uma das ferramentas personalizadas internas.
Para definir ou alterar a ferramenta personalizada, clique na propriedade CustomTool na janela Propriedades e digite o nome de uma ferramenta personalizada.
Propriedade Namespace de ferramenta personalizada
Se você tiver uma ferramenta personalizada atribuída ao seu projeto, o Namespace da ferramenta personalizada propriedade permite que você especifique o namespace que você deseja atribuir ao código gerado pela ferramenta personalizada.Quando você especifica um valor para o Custom Tool Namespace propriedade, o código gerado pela ferramenta é colocada no namespace especificado.Se a propriedade estiver vazia, o código gerado é colocado no espaço para nome padrão para a pasta na qual o arquivo convertido está localizado.Para Visual Basic, esse é o namespace raiz do projeto, e para Visual C# isso corresponde à configuração da propriedade DefaultNamespace para a pasta.
Consulte também
Referência
Configurações Debug e Release projeto
Conceitos
Modelos de projeto padrão em Visual Studio
Tipos de arquivo e extensões de arquivo em Visual Basic e C# Visual