Propriedades de Arquivo

Artigo
08/25/2010

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 incorporado à 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 do Visual Basic e Visual translation from VPE for Csharp têm quatro propriedades: FileName, BuildAction, CustomTool, and CustomToolNamespace.

Observação:
O BuildAction, CustomTool, and CustomToolNamespace propriedades são fornecidas para cenários avançados.Os valores padrão são normalmente suficientes e não precisam ser alterados.

Propriedade FileName

Você pode renomear um arquivo, clicando na propriedade FileName na janela Propriedades e digitando no novo nome.Observe que se você alterar o nome do arquivo, o Visual Studio automaticamente renomeará qualquer arquivo .vb ou .resx associados a ele.

Propriedade BuildAction

A propriedade BuildAction indica o que Visual Studio faz com um arquivo quando uma compilação é executada.BuildAction 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á incorporado na saída principal compilação do projeto como uma DLL ou executável.Ele é normalmente usado para os arquivos de recurso.

O valor padrão para BuildAction depende da extensão do arquivo que você adicionar à solução.Por exemplo, se você adicionar um projeto Visual Basic para Gerenciador de Soluções, o valor padrão para BuildAction é Compile .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 propriedade DefaultNamespace em um projeto do Visual C# ou da propriedade RootNamespace em um projeto do Visual Basic.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á incorporado no conjunto de módulos (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 gerada automaticamente para o arquivo .resx.Portanto, você não deve alterar esta configuração para Embedded Resource, porque fazer isso deverá 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 Classe ResourceManager.Para obter mais informações sobre como acessar todos os outros arquivos incorporados e recursos em tempo de execução, consulte Método Assembly.GetManifestResourceStream.

Propriedade CopyToOutputDirectory

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.

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.

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 CustomTool

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 CustomToolNamespace

Se você tiver uma ferramenta personalizada atribuída a seu projeto, a propriedade CustomToolNamespace permite que você especifique o namespace que você deseja atribuir ao código gerado pela ferramenta personalizada.Quando você especificar um valor para a propriedade CustomToolNamespace, o código gerado pela ferramenta será colocado no namespace especificado.Se a propriedade estiver vazia, o código gerado é colocado no namespace 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

Propriedades de Arquivo

Propriedade FileName

Propriedade BuildAction

Propriedade CopyToOutputDirectory

Propriedade CustomTool

Propriedade CustomToolNamespace

Consulte também

Conceitos

Referência

Outros recursos

Recursos adicionais