Passo a passo: Criando um Item de projeto de ação personalizada com um modelo de Item, parte 1

Artigo
02/25/2013

Você pode estender o sistema do projeto do SharePoint no Visual Studio para criar seus próprios tipos de item de projeto.Em essa explicação passo a passo, você criará um item de projeto que pode ser adicionado a um projeto do SharePoint criar uma ação personalizada em um site da web do SharePoint.A ação personalizada adiciona um item de menu para o menu de Ações do Site de site web do SharePoint.

Essa explicação passo a passo demonstra as seguintes tarefas:

Criando uma extensão do Visual Studio que define um novo tipo de item de projeto do SharePoint para uma ação personalizada.O novo tipo de item de projeto implementa vários recursos personalizados:
- Um menu de atalho que servisse como um ponto de partida para tarefas adicionais relacionados ao item de projeto, como exibir um designer para a ação personalizada no Visual Studio.
- O código que executa quando um desenvolvedor altera certas propriedades de item de projeto e de projeto que o contém.
- Um ícone personalizado que aparece próxima ao item de projeto em Gerenciador de Soluções.
Criando um modelo de item do Visual Studio para o item de projeto.
Criando um pacote de extensão (Visual Studio) VSIX para implantar o modelo de item de projeto e o assembly de extensão.
Depuração e teste o item de projeto.

este é um passo a passo autônomo.Depois que você concluir essa explicação passo a passo, você pode melhorar o item de projeto adicionando um assistente o modelo de item.Para obter mais informações, consulte Passo a passo: Criando um Item de projeto de ação personalizada com um modelo de Item, parte 2.

Observação
Você pode baixar um exemplo que contém os projetos terminado, o código, e outros arquivos para essa explicação passo a passo de seguinte local: https://go.microsoft.com/fwlink/?LinkId=191369.

Pré-requisitos

Você precisa dos seguintes componentes no computador de desenvolvimento de concluir este explicação passo a passo:

Edições suportadas do Microsoft Windows, do SharePoint e Visual Studio.Para obter mais informações, consulte Requisitos para o desenvolvimento de soluções do SharePoint.
O SDK do Visual Studio.Essa explicação passo a passo usa o modelo de projeto de VSIX no SDK para criar um conjunto de VSIX para implantar o item de projeto.Para obter mais informações, consulte Estender as ferramentas do SharePoint em Visual Studio.

Conhecer os seguintes conceitos é útil, mas não necessário, concluir a explicação passo a passo:

Ações personalizadas no SharePoint.Para obter mais informações, consulte Ação personalizada.
Modelos de item no Visual Studio.Para obter mais informações, consulte Introdução aos modelos de Visual Studio.

Criando projetos

Para concluir esta explicação passo a passo, você precisa criar três projetos:

um projeto de VSIX.Este projeto cria o conjunto de VSIX para implantar o item de projeto do SharePoint.
Um projeto modelo de item.Este projeto cria um modelo de item que pode ser usado para adicionar o item de projeto do SharePoint para um projeto do SharePoint.
Um projeto de biblioteca de classes.Este projeto implementa uma extensão do Visual Studio que define o comportamento de item de projeto do SharePoint.

Inicie o passo-a-passo criando projetos.

Para criar o projeto VSIX

Inicie o Visual Studio
Em a barra de menu, escolha Arquivo, Novo, Projeto.
Em a lista na parte superior da caixa de diálogo de Novo Projeto , certifique-se que está selecionado o .NET Framework 4,5 .

Em a caixa de diálogo de Novo Projeto , expanda os nós de Visual C# ou de Visual Basic , e então escolha o nó de Extensibilidade .

Observação
O nó de Extensibilidade está disponível somente se você instalar o Visual Studio SDK.Para obter mais informações, consulte a seção de pré-requisito anteriormente em este tópico.

Escolha o modelo de projeto de VSIX .
Em a caixa de Nome , entre em CustomActionProjectItem, e então escolha o botão de OK .

Visual Studio adiciona o projeto de CustomActionProjectItem a Gerenciador de Soluções.

Para criar o projeto do modelo de item

Em Gerenciador de Soluções, abra o menu de atalho para o nó da solução, escolha Adicionar, e então escolha Novo Projeto.

Observação
Em projetos Visual Basic, o nó da solução aparece em Gerenciador de Soluções somente quando a caixa de seleção de Sempre mostrar solução está selecionada em General, Projects and Solutions, Options Dialog Box.

Em a lista na parte superior da caixa de diálogo de Novo Projeto , certifique-se que está selecionado o .NET Framework 4,5 .
Em a caixa de diálogo de Novo Projeto , expanda os nós de Visual C# ou de Visual Basic , e então escolha o nó de Extensibilidade .
Em a lista de modelos de projeto, escolha o modelo de Modelo de item C# ou de Modelo de item do Visual Basic .
Em a caixa de Nome , entre em ItemTemplate, e então escolha o botão de OK .

Visual Studio adiciona o projeto de ItemTemplate à solução.

Para criar o projeto de extensão

Em Gerenciador de Soluções, abra o menu de atalho para o nó da solução, escolha Adicionar, e então escolha Novo Projeto.
Em a lista na parte superior da caixa de diálogo de Novo Projeto , certifique-se que está selecionado o .NET Framework 4,5 .
Em a caixa de diálogo de Novo Projeto , expanda os nós de Visual C# ou de Visual Basic , escolha o nó de Janelas , e então escolha o modelo de projeto Biblioteca de Classes .
Em a caixa de Nome , insira ProjectItemDefinition, e então escolha o botão de OK .

Visual Studio adiciona o projeto de ProjectItemDefinition a solução e abre o arquivo de código Class1 de opção.
Exclua o arquivo de código Class1 do projeto.

Configurando o projeto de extensão

Antes que você escreva código para definir o tipo de item de projeto do SharePoint, você precisa adicionar arquivos de código e as referências assembly para a extensão projeto.

para configurar o projeto

Em Gerenciador de Soluções, abra o menu de atalho para o projeto de ProjectItemDefinition , escolha Adicionar, então escolha Novo Item.
Em a lista de itens de projeto, escolha Arquivo de Código.
Em a caixa de Nome , digite o nome CustomAction com a extensão de nome de arquivo apropriado, e então escolha o botão de Adicionar .
Em Gerenciador de Soluções, abra o menu de atalho para o projeto de ProjectItemDefinition , e então escolha Adicionar Referência.
Em a caixa de diálogo de Gerenciador de referência – ProjectItemDefinition , escolha o nó de Assemblies , e então escolha o nó de estrutura .
Selecione a caixa de seleção ao lado de cada um dos seguintes conjuntos de módulos (assemblies):
- System.ComponentModel.Composition
- System.Windows.Forms
Escolha o nó de Extensões , selecione a caixa de seleção próxima ao conjunto de Microsoft.VisualStudio.Sharepoint, e então escolha o botão de OK .

Definindo o novo tipo de item de projeto do SharePoint

Crie uma classe que implementa a interface de ISharePointProjectItemTypeProvider para definir o comportamento de tipo de item de projeto.Implementar essa interface sempre que você deseja definir um novo tipo de item de projeto.

Para definir um novo tipo de item de projeto do SharePoint

Em o projeto de ProjectItemDefinition, abra o arquivo de código de CustomAction.

Substitua o código em este arquivo com o código a seguir.

Imports System
Imports System.Diagnostics
Imports System.ComponentModel
Imports System.ComponentModel.Composition
Imports Microsoft.VisualStudio.SharePoint

Namespace Contoso.SharePointProjectItems.CustomAction

    ' Export attribute: Enables Visual Studio to discover and load this extension.
    ' SharePointProjectItemType attribute: Specifies the ID for this new project item type. This string must 
    '     match the value of the Type attribute of the ProjectItem element in the .spdata file for 
    '     the project item.
    ' SharePointProjectItemIcon attribute: Specifies the icon to display with this project item in Solution Explorer.
    ' CustomActionProjectItemTypeProvider class: Defines a new type of project item that can be used to create a custom 
    '     action on a SharePoint site.
    <Export(GetType(ISharePointProjectItemTypeProvider))> _
    <SharePointProjectItemType("Contoso.CustomAction")> _
    <SharePointProjectItemIcon("ProjectItemDefinition.CustomAction_SolutionExplorer.ico")> _
    Partial Friend Class CustomActionProjectItemTypeProvider
        Implements ISharePointProjectItemTypeProvider

        Private WithEvents projectItemTypeDefinition As ISharePointProjectItemTypeDefinition

        ' Configures the behavior of the project item type.
        Private Sub InitializeType(ByVal projectItemTypeDefinition As ISharePointProjectItemTypeDefinition) _
            Implements ISharePointProjectItemTypeProvider.InitializeType

            projectItemTypeDefinition.Name = "CustomAction"
            projectItemTypeDefinition.SupportedDeploymentScopes = _
                SupportedDeploymentScopes.Site Or SupportedDeploymentScopes.Web
            projectItemTypeDefinition.SupportedTrustLevels = SupportedTrustLevels.All
            Me.projectItemTypeDefinition = projectItemTypeDefinition
        End Sub

        Private Const DesignerMenuItemText As String = "View Custom Action Designer"

        Private Sub ProjectItemMenuItemsRequested(ByVal Sender As Object, _
            ByVal e As SharePointProjectItemMenuItemsRequestedEventArgs) _
            Handles projectItemTypeDefinition.ProjectItemMenuItemsRequested

            Dim viewDesignerMenuItem As IMenuItem = e.ViewMenuItems.Add(DesignerMenuItemText)
            AddHandler viewDesignerMenuItem.Click, AddressOf MenuItemClick
        End Sub

        Private Sub MenuItemClick(ByVal Sender As Object, ByVal e As MenuItemEventArgs)
            Dim projectItem As ISharePointProjectItem = CType(e.Owner, ISharePointProjectItem)
            Dim message As String = String.Format("You clicked the menu on the {0} item. " & _
                "You could perform some related task here, such as displaying a designer " & _
                "for the custom action.", projectItem.Name)
            System.Windows.Forms.MessageBox.Show(message, "Contoso Custom Action")
        End Sub

        Private Sub ProjectItemNameChanged(ByVal Sender As Object, ByVal e As NameChangedEventArgs) _
            Handles projectItemTypeDefinition.ProjectItemNameChanged
            Dim projectItem As ISharePointProjectItem = CType(Sender, ISharePointProjectItem)
            Dim message As String = String.Format("The name of the {0} item changed to: {1}", _
                e.OldName, projectItem.Name)
            projectItem.Project.ProjectService.Logger.WriteLine(message, LogCategory.Message)
        End Sub
    End Class
End Namespace

using System;
using System.Diagnostics;
using System.ComponentModel;
using System.ComponentModel.Composition;
using Microsoft.VisualStudio.SharePoint;

namespace Contoso.SharePointProjectItems.CustomAction
{
    // Enables Visual Studio to discover and load this extension.
    [Export(typeof(ISharePointProjectItemTypeProvider))]

    // Specifies the ID for this new project item type. This string must match the value of the 
    // Type attribute of the ProjectItem element in the .spdata file for the project item.
    [SharePointProjectItemType("Contoso.CustomAction")]

    // Specifies the icon to display with this project item in Solution Explorer.
    [SharePointProjectItemIcon("ProjectItemDefinition.CustomAction_SolutionExplorer.ico")]

    // Defines a new type of project item that can be used to create a custom action on a SharePoint site.
    internal partial class CustomActionProjectItemTypeProvider : ISharePointProjectItemTypeProvider
    {
        // Implements IProjectItemTypeProvider.InitializeType. Configures the behavior of the project item type.
        public void InitializeType(ISharePointProjectItemTypeDefinition projectItemTypeDefinition)
        {
            projectItemTypeDefinition.Name = "CustomAction";
            projectItemTypeDefinition.SupportedDeploymentScopes =
                SupportedDeploymentScopes.Site | SupportedDeploymentScopes.Web;
            projectItemTypeDefinition.SupportedTrustLevels = SupportedTrustLevels.All;

            projectItemTypeDefinition.ProjectItemNameChanged += ProjectItemNameChanged;
            projectItemTypeDefinition.ProjectItemMenuItemsRequested += ProjectItemMenuItemsRequested;
        }

        private const string designerMenuItemText = "View Custom Action Designer";

        private void ProjectItemMenuItemsRequested(object sender, SharePointProjectItemMenuItemsRequestedEventArgs e)
        {
            e.ViewMenuItems.Add(designerMenuItemText).Click += MenuItemClick;
        }

        private void MenuItemClick(object sender, MenuItemEventArgs e)
        {
            ISharePointProjectItem projectItem = (ISharePointProjectItem)e.Owner;
            string message = String.Format("You clicked the menu on the {0} item. " +
                "You could perform some related task here, such as displaying a designer " +
                "for the custom action.", projectItem.Name);
            System.Windows.Forms.MessageBox.Show(message, "Contoso Custom Action");
        }

        private void ProjectItemNameChanged(object sender, NameChangedEventArgs e)
        {
            ISharePointProjectItem projectItem = (ISharePointProjectItem)sender;
            string message = String.Format("The name of the {0} item changed to: {1}",
                e.OldName, projectItem.Name);
            projectItem.Project.ProjectService.Logger.WriteLine(message, LogCategory.Message);
        }
    }
}

Criando um ícone para o item de projeto no solution Explorer

Quando você cria um item de projeto personalizado do SharePoint, você pode associar uma imagem (um ícone ou um bitmap) com o item de projeto.Esta imagem aparece próxima ao item de projeto em Gerenciador de Soluções.

Em o procedimento a seguir, você cria um ícone para o item de projeto e insere o ícone no assembly de extensão.Este ícone é referenciado por SharePointProjectItemIconAttribute da classe de CustomActionProjectItemTypeProvider que você criou anteriormente.

Para criar um ícone personalizado para o item de projeto

Em Gerenciador de Soluções, abra o menu de atalho para o projeto de ProjectItemDefinitionAdicionar, escolha, e escolha Novo Item...
Em a lista de itens de projeto, escolha o item de Arquivo de Ícone .

Observação

Em projetos Visual Basic, você deve escolher o nó de Geral para exibir o item de Arquivo de Ícone .
Em a caixa de Nome , entre em CustomAction_SolutionExplorer.ico, e então escolha o botão de Adicionar .

o novo ícone abre em Editor de Imagem.
Edite a versão 16x16 do arquivo de ícone de modo que tenha um design que você pode identificar e em seguida, salve o arquivo de ícone.
Em Gerenciador de Soluções, escolha CustomAction_SolutionExplorer.ico.
Em a janela de Propriedades , escolha a seta próxima à propriedade de Ação de Compilação .
Em a lista que aparece, escolha Recurso Incorporado.

Observação
Em projetos Visual Basic, você deve escolher o nó de Geral para exibir o item de Arquivo de Ícone .

Ponto de Verificação

Em esse ponto do passo-a-passo, todo o código para o item de projeto agora está no projeto.Compile o projeto para verificar que compila sem erros.

Para criar seu projeto

Abra o menu de atalho para o projeto de ProjectItemDefinition e escolha Compilar.

Criando um modelo de item do Visual Studio

Para ativar outros desenvolvedores para usar o item de projeto, você deve criar um modelo de projeto ou modelo de item.Os desenvolvedores usam esses modelos no Visual Studio para criar uma instância do item de projeto criando um novo projeto, ou adicionando um item a um projeto existente.Para essa explicação passo a passo, use o projeto de ItemTemplate configurar o item de projeto.

Para criar o modelo de item

Exclua o arquivo de código Class1 de projeto ItemTemplate.
Em o projeto de ItemTemplate, abra o arquivo de ItemTemplate.vstemplate.

Substitua o conteúdo do arquivo com o seguinte XML, e então salve e feche o arquivo.

Observação
O seguinte XML é para um modelo de item visual C#.Se você estiver criando um modelo de item do Visual Basic, substitua o valor do elemento de ProjectType com VisualBasic.

<?xml version="1.0" encoding="utf-8"?>
<VSTemplate Version="2.0.0" xmlns="https://schemas.microsoft.com/developer/vstemplate/2005" Type="Item">
  <TemplateData>
    <DefaultName>CustomAction</DefaultName>
    <Name>Custom Action</Name>
    <Description>SharePoint Custom Action by Contoso</Description>
    <ProjectType>CSharp</ProjectType>
    <SortOrder>1000</SortOrder>
    <Icon>ItemTemplate.ico</Icon>
    <ProvideDefaultName>true</ProvideDefaultName>
  </TemplateData>
  <TemplateContent>
    <ProjectItem ReplaceParameters="true" TargetFileName="$fileinputname$\Elements.xml">Elements.xml</ProjectItem>
    <ProjectItem ReplaceParameters="true" TargetFileName="$fileinputname$\SharePointProjectItem.spdata">CustomAction.spdata</ProjectItem>
  </TemplateContent>
</VSTemplate>

Esse arquivo define o conteúdo e o comportamento do modelo de item.Para obter mais informações sobre conteúdo do arquivo, consulte Referência do esquema de modelo do Visual Studio.

Em Gerenciador de Soluções, abra o menu de atalho para o projeto de ItemTemplateAdicionar, escolha, e escolha Novo Item.
Em a caixa de diálogo de Adicionar novo item , escolha o modelo de Arquivo de Texto .
Em a caixa de Nome , entre em CustomAction.spdata, e então escolha o botão de Adicionar .
Adicione o seguinte XML para o arquivo de CustomAction.spdata, e então salve e feche o arquivo.
```
<?xml version="1.0" encoding="utf-8"?>
<ProjectItem Type="Contoso.CustomAction" DefaultFile="Elements.xml" 
 xmlns="https://schemas.microsoft.com/VisualStudio/2010/SharePointTools/SharePointProjectItemModel">
  <Files>
    <ProjectItemFile Source="Elements.xml" Target="$fileinputname$\" Type="ElementManifest" />
  </Files>
</ProjectItem>
```
Este arquivo contém informações sobre os arquivos que está contido no item de projeto.O atributo de Type do elemento de ProjectItem deve ser definido para a mesma cadeia de caracteres que é passada para SharePointProjectItemTypeAttribute na definição do item de projeto (a classe de CustomActionProjectItemTypeProvider você criou anteriormente em essa explicação passo a passo.)Para obter mais informações sobre conteúdo de arquivos de .spdata, consulte Referência de esquema de Item de projeto do SharePoint.
Em Gerenciador de Soluções, abra o menu de atalho para o projeto de ItemTemplateAdicionar, escolha, e escolha Novo Item.
Em a caixa de diálogo de Adicionar novo item , escolha o modelo de Arquivo XML .
Em a caixa de Nome , entre em Elements.xml, e então escolha o botão de Adicionar .

Substitua o conteúdo do arquivo de Elements.xml com o seguinte XML, e então salve e feche o arquivo.

<?xml version="1.0" encoding="utf-8" ?>
<Elements Id="$guid8$" xmlns="https://schemas.microsoft.com/sharepoint/">
  <CustomAction Id="Replace this with a GUID or some other unique string"
                GroupId="SiteActions"
                Location="Microsoft.SharePoint.StandardMenu"
                Sequence="1000"
                Title="Replace this with your title"
                Description="Replace this with your description" >
    <UrlAction Url="~site/Lists/Tasks/AllItems.aspx"/>
  </CustomAction>
</Elements>

Esse arquivo define uma ação personalizada padrão que cria um item de menu no menu de Ações do Site de site web do SharePoint.Quando um usuário escolher o item de menu, na URL especificada no elemento de UrlAction abre no navegador da web.Para obter mais informações sobre os elementos XML que você pode usar para definir uma ação personalizada, consulte Definições personalizadas de ação.

Opcionalmente, abra o arquivo de ItemTemplate.ico e altere-o para que tenha um design que você possa reconhecer.Este ícone exibirá próxima ao item de projeto na caixa de diálogo de Adicionar novo item .
Em Gerenciador de Soluções, abra o menu de atalho para o projeto de ItemTemplate , e então escolha Descarregar projeto.
Abra o menu de atalho para o projeto de ItemTemplate novamente, e então escolha edição ItemTemplate.csproj ou edição ItemTemplate.vbproj.
Localize o elemento de VSTemplate no arquivo de projeto.
```
<VSTemplate Include="ItemTemplate.vstemplate">
```
Substitua esse elemento de VSTemplate com o seguinte XML, e então salve e feche o arquivo.
```
<VSTemplate Include="ItemTemplate.vstemplate">
  <OutputSubPath>SharePoint\SharePoint14</OutputSubPath>
</VSTemplate>
```
O elemento de OutputSubPath especifica pastas adicionais em com que o modelo de item é criado quando você compila o projeto.As pastas especificadas aqui garantem que o modelo de item está disponível apenas quando clientes abre a caixa de diálogo de Adicionar novo item , expanda o nó de SharePoint , e escolha no nó de 2010 .
Em Gerenciador de Soluções, abra o menu de atalho para o projeto de ItemTemplate , e então escolha Recarregar projeto.

Criando um conjunto de VSIX para implantar o item de projeto

Para implantar a extensão, use o projeto de VSIX em sua solução criar um conjunto de VSIX.Primeiro, configure o conjunto de VSIX modificando o arquivo de source.extension.vsixmanifest que está incluído no projeto de VSIX.Em seguida, crie o conjunto de VSIX criando a solução.

Para configurar e criar o conjunto de VSIX

Em Gerenciador de Soluções, abra o menu de atalho para o arquivo de source.extension.vsixmanifest no projeto de CustomActionProjectItem, e então escolha Abrir.

O Visual Studio abre o arquivo no editor manifesto.O arquivo de source.extension.vsixmanifest é a base para o arquivo de extension.vsixmanifest que quaisquer pacotes de VSIX exigem.Para obter mais informações sobre este arquivo, consulte Referência de esquema de extensão VSIX.
Em a caixa de Nome do produto , entre em Item de projeto personalizado de ação.
Em a caixa de Autor , entre em Contoso.
Em a caixa de Descrição , entre em Um item de projeto do SharePoint que representa uma ação personalizada.
Em a guia de Ativos , escolha o botão de Novo .

a caixa de diálogo de adicionar o novo recurso aparece.

Em a lista de Tipo , escolha Microsoft.VisualStudio.ItemTemplate.

Observação
Esse valor corresponde ao elemento de ItemTemplate no arquivo de extension.vsixmanifest.Esse elemento identifica a subpasta no pacote de VSIX que contém o projeto modelo de item.Para obter mais informações, consulte ItemTemplate Element.

Em a lista de Origem , escolha Um projeto na solução atual.
Em a lista de Projeto , escolha, e escolha ItemTemplateno botão de OK .
Em a guia de Ativos , escolha o botão de Novo novamente.

a caixa de diálogo de adicionar o novo recurso aparece.

Em a lista de Tipo , escolha Microsoft.VisualStudio.MefComponent.

Observação
Esse valor corresponde ao elemento de MefComponent no arquivo de extension.vsixmanifest.Esse elemento especifica o nome de um assembly de extensão no conjunto de VSIX.Para obter mais informações, consulte MEFComponent Element.

Em a lista de Origem , escolha Um projeto na solução atual.
Em a lista de Projeto , escolha ProjectItemDefinition.
Escolha o botão OK.
Em a barra de menu, escolha Compilar, Compilar solução, e então certifique-se de que o projeto compila sem erros.
Certifique-se de que a pasta de saída de compilação para o projeto de CustomActionProjectItem contém o arquivo de CustomActionProjectItem.vsix.

Por padrão, a pasta de saída de compilação é.\ bin \ debug de sob a pasta que contém o projeto de CustomActionProjectItem.

Testando o item de projeto

Você agora está pronto para testar o item de projeto.Primeiro, iniciar a depuração da solução CustomActionProjectItem na instância de avaliação do Visual Studio.Em seguida, testar o item de projeto de Ação Personalizada em um projeto do SharePoint na instância de avaliação do Visual Studio.Finalmente, compilação e executar o projeto do SharePoint verifique que a ação personalizada funcione como esperado.

Para iniciar a depuração da solução

Reinicie o Visual Studio com credenciais administrativas, e abra a solução de CustomActionProjectItem.
Abra o arquivo de código de CustomAction, e adicione um ponto de interrupção na primeira linha de código no método de InitializeType .
Escolha a chave de F5 para iniciar a depuração.

O Visual Studio instala a extensão em %UserProfile%\AppData\Local\Microsoft\VisualStudio\10.0Exp\Extensions\Contoso\Custom Action Project Item\1.0 e inicia uma instância de avaliação do Visual Studio.Você irá testar o item de projeto em esse caso do Visual Studio.

Para testar o item de projeto no Visual Studio

Em a instância de avaliação do Visual Studio, na barra de menu, escolha Arquivo, Novo, Projeto.
Expanda Visual C# ou Visual Basic (dependendo do idioma que seu modelo de item suporta), expanda SharePoint, e então escolha o nó de 2010 .
Em a lista de modelos de projeto, escolha Projeto do SharePoint 2010.
Em a caixa de Nome , entre em CustomActionTest, e então escolha o botão de OK .
Em Assistente de personalização do SharePoint, digite o URL do site que você deseja usar para depuração, e então escolha o botão de Concluir .
Em Gerenciador de Soluções, abra o menu de atalho para o nó de projeto Adicionar, escolha, e escolha Novo Item.
Em a caixa de diálogo de Adicionar novo item , escolha o nó de 2010 sob o nó de SharePoint .

Verifique se o item de Ação Personalizada aparece na lista de itens de projeto.
Escolha o item de Ação Personalizada , e então escolha o botão de Adicionar .

O Visual Studio adiciona um item que é chamado CustomAction1 ao seu projeto e abre o arquivo de Elements.xml no editor.
Verifique se o código em outra instância do Visual Studio pára no ponto de interrupção que anteriormente definido no método de InitializeType .
Escolha a chave de F5 para continuar a depuração o projeto.
Em a instância de avaliação do Visual Studio, em Gerenciador de Soluções, abra o menu de atalho para o nó de CustomAction1 , e então escolha Designer personalizado de ação de exibição.
Verifique se um caixa de mensagem aparece, e então escolha o botão de OK .

Você pode usar esse menu de atalho para fornecer comandos ou opções adicionais para os desenvolvedores, como exibir um designer para a ação personalizada.
Em a barra de menu, escolha Modo de Visualização, Saída.

A janela Output é aberta.
Em Gerenciador de Soluções, abra o menu de atalho para o item de CustomAction1 em seguida, altere seu nome para MyCustomAction.

Em a janela de Saída , uma mensagem de confirmação é exibida.Essa mensagem é escrita pelo manipulador de eventos de ProjectItemNameChanged que você definiu na classe de CustomActionProjectItemTypeProvider .Você pode manipular esse evento e outros eventos de item de projeto para implementar comportamento personalizado quando o desenvolvedor altera o item de projeto.

Para testar a ação personalizada no SharePoint

Em a instância de avaliação do Visual Studio, abra o arquivo de Elements.xml que é um filho do item de projeto de MyCustomAction .
Em o arquivo de Elements.xml, faça as seguintes alterações e em seguida, salve o arquivo:
- Em o elemento de CustomAction , defina o atributo de Id a GUID ou qualquer outra cadeia de caracteres exclusiva como mostra o exemplo a seguir:
```
Id="cd85f6a7-af2e-44ab-885a-0c795b52121a"
```
- Em o elemento de CustomAction , defina o atributo de Title como mostra o exemplo a seguir:
```
Title="SharePoint Developer Center"
```
- Em o elemento de CustomAction , defina o atributo de Description como mostra o exemplo a seguir:
```
Description="Opens the SharePoint Developer Center Web site."
```
- Em o elemento de UrlAction , defina o atributo de Url como mostra o exemplo a seguir:
```
Url="https://msdn.microsoft.com/sharepoint/default.aspx"
```
Escolha a tecla F5.

A ação personalizada é empacotada e implantado para o site do SharePoint que é especificada na propriedade de URL do Site do projeto.Navegador da web abre a página padrão de esse site.

Observação

Se a caixa de diálogo aparece Depuração de Script Desabilitada , escolha o botão de Sim para continuar a depuração o projeto.
Em o menu de Ações do Site , escolha Centro de Desenvolvedores do SharePoint, verifique que o navegador abre o site https://msdn.microsoft.com/sharepoint/default.aspx, e então fecha navegador da web.

Observação
Se a caixa de diálogo aparece Depuração de Script Desabilitada , escolha o botão de Sim para continuar a depuração o projeto.

Limpando o computador de desenvolvimento

Depois que você concluir testar o item de projeto, remova o modelo de item de projeto de instância de avaliação do Visual Studio.

Para limpar o computador de desenvolvimento

Em a instância de avaliação do Visual Studio, na barra de menu, escolha Ferramentas, Extensões e Atualizações.

a caixa de diálogo de Extensões e Atualizações abre.
Em a lista de extensões Item de projeto personalizado de ação, escolha, e escolha no botão de Desinstalar .
Em a caixa de diálogo que aparece, escolha o botão de Sim para confirmar que você deseja desinstalar a extensão.
Escolha o botão de Reiniciar Agora para concluir a desinstalação.
Feche a instância de avaliação do Visual Studio e a instância na qual a solução de CustomActionProjectItem é aberta.

Próximas etapas

Depois que você concluir essa explicação passo a passo, você pode adicionar um assistente o modelo de item.Quando um usuário adiciona um item de projeto personalizado de ação para um projeto do SharePoint, o assistente coleta informações sobre a ação (como o local e o URL para navegar quando a ação é escolhida) e adiciona essa informação para o arquivo de Elements.xml no novo item de projeto.Para obter mais informações, consulte Passo a passo: Criando um Item de projeto de ação personalizada com um modelo de Item, parte 2.

Consulte também

Partilhar via