Estendendo os itens de projeto do SharePoint

Artigo
02/25/2013

Crie uma extensão de item de projeto quando você deseja adicionar funcionalidade a um tipo de item de projeto do SharePoint que já está instalado no Visual Studio.Por exemplo, você pode criar uma extensão para Receptor de eventos interna ou itens de projeto de Definição de lista no Visual Studio, ou você pode criar uma extensão para um tipo de item de projeto personalizado.Você também pode criar uma extensão para todos os tipos de itens de projeto do SharePoint.

Tarefas para estender itens de projeto do SharePoint

Para estender um item de projeto, criar um assembly de extensão do Visual Studio que implementa a interface de ISharePointProjectItemTypeExtension .Para obter mais informações, consulte Como: criar uma extensão de Item de projeto do SharePoint.

Quando você estender um item de projeto, você também pode adicionar a seguinte funcionalidade ao item de projeto:

Adicionar um item de menu de atalho para o item de projeto.O item de menu aparece quando você abre o menu de atalho para o item de projeto em Gerenciador de Soluções.Abra o menu de atalho clique com o botão direito no item de projeto ou escolhendo o e então escolha das teclas SHIFT + de F10.Para obter mais informações, consulte Como: adiciona um Item de Menu de atalho para uma extensão de Item de projeto do SharePoint.
Adicione uma propriedade personalizada ao item de projeto.A propriedade aparece na janela de Propriedades quando você escolhe o item de projeto em Gerenciador de Soluções.Para obter mais informações, consulte Como: adicionar uma propriedade para uma extensão de Item de projeto do SharePoint.

Para uma explicação passo a passo que demonstra como para criar, implantar, e para testar uma extensão de item de projeto, consulte Passo a passo: Estendendo um tipo de Item de projeto do SharePoint.

Entendendo a relação entre as extensões de item de projeto e instâncias de item de projeto

Quando você cria uma extensão de item de projeto, Visual Studio carrega sua extensão quando um item de projeto do tipo associado é adicionado a um projeto do SharePoint.Por exemplo, se você criar uma extensão para itens de projeto de Receptor de eventos , o Visual Studio carrega sua extensão quando um usuário adiciona um item de projeto de Receptor de eventos a um projeto.O Visual Studio usa a mesma instância da sua extensão para todas as instâncias do tipo de item de projeto associado.Em o exemplo anterior, se o usuário adiciona um item de projeto de Receptor de eventos do segundo ao projeto, a mesma instância da sua extensão é usada para personalizar o segundo item de projeto.

Para acessar uma instância específica de tipo de item de projeto que você estiver estendendo, manipula um dos eventos de ISharePointProjectItemEvents de parâmetro de projectItemType na implementação do método de ISharePointProjectItemTypeExtension.Initialize .Por exemplo, para determinar quando um item de projeto do tipo que você estiver estendendo é adicionado a um projeto, manipular o evento de ProjectItemAdded .Para obter mais informações, consulte Como: criar uma extensão de Item de projeto do SharePoint.

Identificadores para itens de projeto do SharePoint

Cada item de projeto do SharePoint tem um identificador correspondente da cadeia de caracteres.Você deve saber o identificador para um item de projeto se você deseja executar as seguintes tarefas:

Crie uma extensão para o item de projeto.Em esse caso, você deve passar o identificador para o item de projeto que você deseja estender para o construtor de SharePointProjectItemTypeAttribute.Para criar uma extensão para todos os tipos de itens de projeto, passar o valor da cadeia de caracteres de * .
Adicionar o item de projeto para um projeto por meio de programação.Em esse caso, você deve passar o identificador para o item de projeto para o método de ISharePointProjectItemCollection.Add .

A tabela a seguir lista os identificadores para itens de projeto do SharePoint que são incluídos com o Visual Studio.

Nome do item de projeto	Identificador de cadeia de caracteres
Modelo de catálogo de dados corporativos	Microsoft.VisualStudio.SharePoint.BusinessDataConnectivity
Tipo de Conteúdo	Microsoft.VisualStudio.SharePoint.ContentType
Receptor de eventos	Microsoft.VisualStudio.SharePoint.EventHandler
O elemento vazio	Microsoft.VisualStudio.SharePoint.GenericElement
Definição de lista Definição de lista de tipos de conteúdo	Microsoft.VisualStudio.SharePoint.ListDefinition
Instância de lista	Microsoft.VisualStudio.SharePoint.ListInstance
Module	Microsoft.VisualStudio.SharePoint.Module
fluxo de trabalho seqüencial Fluxo de trabalho do computador de estado	Microsoft.VisualStudio.SharePoint.Workflow
Definição do site	Microsoft.VisualStudio.SharePoint.SiteDefinition
Visual Web parts	Microsoft.VisualStudio.SharePoint.VisualWebPart
Web parts	Microsoft.VisualStudio.SharePoint.WebPart
Formulário de associação de fluxo de trabalho	Microsoft.VisualStudio.SharePoint.WorkflowAssociation