Modelos de itens C#, VB e C++
Recolher sumário
Expandir sumário

Modelos de item C#, VB e C++ para aplicativos da Loja

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente ]

Modelos de item são arquivos de aplicativo que contêm um código usado com frequência que pode ser adicionado a um modelo de projeto para reduzir o tempo de desenvolvimento.

Os modelos de item contêm as referências apropriadas e as marcas de script para dar suporte aos aplicativos da Windows Store e da Windows Phone Store. Alguns dos modelos de item implementam um contrato, que funciona como um acordo onde um ou mais aplicativos podem usar APIs específicas. Quando você adiciona um modelo de contrato (Contrato do Seletor de Abertura de Arquivos, Contrato de Destino de Compartilhamento), o manifesto do aplicativo é atualizado com as declarações apropriadas para notificar o Windows ou o Windows Phone que o seu aplicativo dá suporte a esse contrato. Você pode ver as configurações dessas declarações na guia Declarações do Designer de Manifesto.

Você pode adicionar um modelo de item a um projeto clicando com o botão direito do mouse nesse projeto no Gerenciador de Soluções e depois clicando em Adicionar > Novo Item.

Descrições dos modelos

Esta tabela resume os tipos de modelos de item disponíveis em Visual C#, Visual Basic ou Visual C++ para aplicativos do Tempo de Execução do Windows.

ModeloDescriçãoExige arquivos comuns
Páginas
Página BásicaUma página mínima, contendo um título e um botão de voltar, que usa NavigationHelper. Sim
Página em BrancoUma página em branco. Não
Página de Detalhes do GrupoUma página que exibe detalhes de um único grupo e visualizações de cada item do grupo. Sim
Página de Itens AgrupadosUma página que exibe visualizações de item organizadas em grupos. Sim
Página HubUma página que exibe visualizações de itens organizadas em seções e que usa uma apresentação variada em cada seção.Sim
Página de Detalhes do ItemUma página que exibe um item em detalhes juntamente com a navegação para os itens adjacentes do mesmo grupo. Sim
Página de ItensUma página que exibe uma coleção de itens. Sim
Página de resultados da pesquisa Uma página que dá suporte à exibição de resultados de pesquisa.Sim
Página DivididaUma página que exibe uma lista de itens e detalhes do item selecionado. Sim
Observação  

O modelo de navegação usado nos modelos de item Controle de Página também é usado nos modelos de projeto Hub, Grade, Dividido e Navegação. Recomendamos que você utilize esse modelo de item ao adicionar páginas a esses modelos de projeto. Para saber mais, veja Guia de início rápido: navegando entre páginas.

 

 

Contratos
Contrato do seletor de abertura de arquivos Um contrato de aplicativo que permite o fornecimento de arquivos para outros aplicativos. Este item permite que um aplicativo exponha seus dados como arquivos para outros aplicativos. Por exemplo, você pode usar esse modelo para criar uma caixa de diálogo seletora de fotos na qual o usuário pode escolher uma foto do Facebook, mesmo que essa foto não esteja armazenada na unidade de disco local. Para saber mais, veja Integrando com contratos de seletor de arquivos.Sim
Contrato de Compartilhamento de Destino Um contrato de aplicativo que dá suporte ao recebimento de itens compartilhados por outros aplicativos. Esse modelo de item permite que um aplicativo coordene o compartilhamento de dados entre outros aplicativos. Por exemplo, você pode usar esse modelo para permitir que os usuários publiquem uma foto do Flickr no Facebook. Esse modelo inclui código que permite que o aplicativo receba conteúdo compartilhado. O aplicativo que contém esse modelo de item é iniciado quando selecionado na interface de usuário de compartilhamento. Para saber mais, veja Início rápido: recebendo conteúdo compartilhado.Sim

 

Outro
Dicionário de Recursos Uma coleção inserida vazia dos recursos XAML. Não
Arquivo de Recursos (.resw) Um arquivo para armazenar e os recursos de cadeia de caracteres e condicionais para seu aplicativo. Para ajudar a localizar um aplicativo da Windows Store, você pode adicionar um ou mais modelos de item de Arquivo de Recursos ao seu projeto. Para saber mais, veja o tópico sobre como globalizar seu aplicativo.Não
Submenu ConfiguraçõesUma página em branco de submenu Configurações.Não
Controle Modelo Um controle personalizado em branco com o estilo padrão adequado. Não
Controle do Usuário Um controle do usuário em branco. Não

 

Adicionando os arquivos necessários

Alguns dos modelos de item da Windows Store e do WIndows Phone, definidos acima, são páginas complexas e contêm dependências em NavigationHelper, SuspensionManager e outros arquivos comuns incluídos nos modelos de projeto. Esses arquivos ficam localizados na pasta Comum, que é automaticamente adicionada quando você cria um aplicativo usando os modelos de projeto Aplicativo de Hub, Aplicativo de Grade ou Aplicativo Dividido. Se qualquer uma das referências necessárias não for encontrada, você será solicitado a adicionar os arquivos necessários.

Observação  Os arquivos necessários variam conforme o modelo de item específico a ser adicionado. A lista completa de arquivos comuns inclui: NavigationHelper, SuspensionManager, RelayCommand, BooleanNegationConverter e BooleanToVisibilityConverter. Para saber mais sobre esses modelos, veja Modelos de projeto em C#/VB/C++ para aplicativos da Windows Store.
 

A tabela a seguir fornece informações sobre como proceder quando você for solicitado a adicionar os arquivos necessários.

AçãoPor que escolher isso?O que ocorre?
Sim
  • Você criou seu aplicativo do modelo de projeto Aplicativo em Branco. Nenhum dos itens comuns são adicionados por padrão e esta é a única forma de adicioná-los automaticamente.
  • Você removeu alguns dos arquivos na pasta Comum, porque você não estava usando-os. Mas o item recém-adicionado pode exigir os arquivos removidos e desejar que você os adicione novamente.

As dependências necessárias são adicionadas à pasta Comum. Se a pasta já existe, todos os itens que estão faltando são adicionados. Nenhum arquivo existente é modificado. Se a pasta não existir, ela será criada e todos os itens serão adicionadas a ela.

Não
  • Os arquivos necessários já existem, mas você renomeou os arquivos ou as classes.
  • Você reorganizou seu projeto e moveu os arquivos da pasta Comum para outro local, como pastas diferentes ou uma biblioteca de classe vinculada.

O novo item é adicionado. Nenhum outro arquivo é adicionado ou modificado.

Cancelar
  • Você decide que não deseja adicionar o item.

O projeto não é alterado, e o item não é adicionado.

 

Tópicos relacionados

Modelos de projeto C#/VB/C++ para aplicativos da Windows Store
Adicionando um modelo de item Controle de Página (em C#/VB/C++ e XAML)
Adicionando um modelo de item Contrato de Pesquisa (em C#/VB/C++ e XAML)

 

 

Mostrar:
© 2017 Microsoft