Compartilhar via

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

  • Artigo

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

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

  • Criação de uma extensão de 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 serve como ponto de partida para tarefas adicionais relacionadas ao item de projeto, como, por exemplo, a exibição de um designer para a ação personalizada em Visual Studio.

    • Código que é executado quando um desenvolvedor altera determinadas propriedades do item de projeto e o projeto que contém a ele.

    • Um ícone personalizado que aparece ao lado do item de projeto no Solution Explorer.

  • Criando um modelo de item Visual Studio para o item de projeto.

  • Construindo um pacote de extensão de Visual Studio (VSIX) para implantar o modelo de item de projeto e a montagem de extensão.

  • O item de projeto de teste e depuração.

Este é um passo a passo autônoma. Depois de concluir este passo a passo, você pode aprimorar o item de projeto, adicionando um Assistente para o modelo de item. Para obter mais informações, consulte Demonstra Passo a passo: A criação de um Item de projeto de ação personalizada com um modelo de Item, parte 2.

ObservaçãoObservação

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

Pré-requisitos

É necessário que os seguintes componentes no computador de desenvolvimento para concluir este passo a passo:

Conhecimento dos seguintes conceitos é útil, mas não necessário para concluir o passo a passo:

A criação de projetos

Para concluir este passo a passo, você precisa criar três projetos:

  • Um projeto VSIX. Este projeto cria o pacote VSIX para implantar o item de projeto do SharePoint.

  • Um projeto de 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 classe. Este projeto implementa uma extensão de Visual Studio que define o comportamento do item de projeto do SharePoint.

Inicie o passo a passo através da criação de projetos.

Para criar o projeto VSIX

  1. Inicie o Visual Studio

  2. No menu File, aponte para New, e em seguida, clique em Project.

  3. Na caixa de combinação na parte superior do Novo projeto caixa de diálogo caixa, certifique-se de que .NET Framework 4 está selecionada.

  4. No Novo projeto caixa de diálogo caixa, expanda o Visual C# ou Visual Basic nós e em seguida, clique o extensibilidade nó.

    ObservaçãoObservação

    O extensibilidade nó só estará disponível se você instalar o SDK de 2010 Visual Studio. Para obter mais informações, consulte a seção de pré-requisitos acima.

  5. Clique o O projeto de VSIX modelo.

  6. No nome , digite CustomActionProjectItem.

  7. Clique em OK.

    Visual StudioAdiciona o CustomActionProjectItem de projeto para Solution Explorer.

Para criar o projeto de modelo de item

  1. Em Solution Explorer, o botão direito do mouse no nó da solução, clique em Adde em seguida, clique em Novo projeto.

    ObservaçãoObservação

    Em projetos de Visual Basic, o nó de solução aparece na Solution Explorer somente quando o Always show solution caixa de seleção estiver marcada na Geral, projetos e soluções, caixa de diálogo Options.

  2. Na caixa de combinação na parte superior do Novo projeto caixa de diálogo caixa, certifique-se de que .NET Framework 4 está selecionada.

  3. No Novo projeto caixa de diálogo caixa, expanda o Visual C# ou Visual Basic nós e em seguida, clique o extensibilidade nó.

  4. Na lista de modelos de projeto, selecione O modelo de Item C# ou Modelo de Item de Visual Basic.

  5. No nome , digite ItemTemplate.

  6. Clique em OK.

    Visual StudioAdiciona o ItemTemplate o projeto à solução.

Para criar o projeto de extensão

  1. Em Solution Explorer, o botão direito do mouse no nó da solução, clique em Adde em seguida, clique em Novo projeto.

  2. Na caixa de combinação na parte superior do Novo projeto caixa de diálogo caixa, certifique-se de que .NET Framework 4 está selecionada.

  3. No Novo projeto caixa de diálogo caixa, expanda o Visual C# ou Visual Basic nós e em seguida, clique o Windows nó.

  4. Selecione o Biblioteca de classe o modelo de projeto.

  5. No nome , digite ProjectItemDefinition.

  6. Clique em OK.

    Visual StudioAdiciona o ProjectItemDefinition o projeto à solução e abre o arquivo de código padrão Class1.

  7. Exclua o arquivo de código Class1 do projeto.

Configurando o projeto de extensão

Antes de escrever código para definir o tipo de item de projeto do SharePoint, você precisará adicionar referências de assembly para o projeto de extensão e de arquivos de código.

Para configurar o projeto.

  1. No projeto ProjectItemDefinition, adicione um arquivos de código com o nome CustomAction.

  2. No menu Project, escolha Add Reference.

  3. Sobre o .NET guia, pressione CTRL e clique os assemblies a seguir e clique em OK:

    • Microsoft.VisualStudio.SharePoint

    • System.ComponentModel.Composition

    • System.Windows.Forms

Definindo o novo tipo de Item de projeto do SharePoint

Criar uma classe que implementa o ISharePointProjectItemTypeProvider interface para definir o comportamento do novo projeto item tipo. Implemente essa interface, sempre que você deseja definir um novo tipo de item de projeto.

Para definir o novo tipo de item de projeto do SharePoint

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

  2. Substitua o código neste 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);
        }
    }
}

A criação de 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 bitmap) com o item de projeto. Essa imagem aparece ao lado do item de projeto no Solution Explorer.

No procedimento a seguir, você pode cria um ícone para o item de projeto e incorpora o ícone na montagem de extensão. Este ícone é referenciado pela SharePointProjectItemIconAttribute da CustomActionProjectItemTypeProvider classe que você criou anteriormente.

Para criar um ícone personalizado para o item de projeto

  1. Em Solution Explorer, com o botão direito do ProjectItemDefinition project.

  2. No menu de atalho, aponte para Adde em seguida, clique em Novo Item.

  3. Na lista de itens de projeto, clique em Arquivo de ícone.

    ObservaçãoObservação

    Em projetos de Visual Basic, você deve clicar na Geral nó para ver o O arquivo de ícone item.

  4. Tipo de CustomAction_SolutionExplorer.ico para o novo nome do ícone e clique em Add.

    O novo ícone abre no O Editor de imagem.

  5. Edite a versão de 16 x 16 do arquivo de ícone para que ele tenha um design que você pode reconhecer e salve o arquivo de ícone.

  6. Em Solution Explorer, clique em CustomAction_SolutionExplorer.ico.

  7. No Propriedades janela, clique na lista suspensa ao lado de Build Action e, em seguida, clique em Embedded Resource.

Ponto de Verificação

Neste momento o passo a passo, todo o código para o item de projeto está agora no projeto. Construa o projeto para certificar-se de que ele foi compilado sem erros.

Para construir seu projeto.

  • Sobre o Build menu, selecione Build Solution.

Criando um modelo de Item de Visual Studio

Para permitir que outros desenvolvedores a usar o item de projeto, você deve criar um modelo de projeto ou de um modelo de item. Os desenvolvedores usar esses modelos em Visual Studio para criar uma instância do seu item de projeto, criando um novo projeto ou adicionando um item a um projeto existente. Para esta explicação, use o projeto ItemTemplate para configurar o seu item de projeto.

Para criar o modelo de item

  1. Exclua o arquivo de código Class1 do projeto ItemTemplate.

  2. No projeto ItemTemplate, abra o arquivo ItemTemplate.vstemplate.

  3. Substitua o conteúdo do arquivo com o XML a seguir, salve e feche o arquivo.

    ObservaçãoObservação

    O XML a seguir é um modelo de item do Visual C#. Se você estiver criando um modelo de item de Visual Basic, substitua o valor da ProjectType elemento com VisualBasic.

    		 
    <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 o conteúdo deste arquivo, consulte Referência de esquema de modelo do Studio Visual.

  4. No Solution Explorer, com o botão direito do ItemTemplate do projeto, clique em Adde, em seguida, clique em Novo Item.

  5. No Add New Item caixa de diálogo, selecione Arquivo de texto, tipo CustomAction.spdata na nome de campo e, em seguida, clique em Add.

  6. Adicione o seguinte XML ao arquivo CustomAction.spdata, 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 contidos no item de projeto. O Type atributo da ProjectItem elemento deve ser definido para a mesma seqüência que é passada para o SharePointProjectItemTypeAttribute na definição de item de projeto (o CustomActionProjectItemTypeProvider classe que você criou anteriormente nesta explicação passo a passo). Para obter mais informações sobre o conteúdo dos arquivos de .spdata, consulte Referência de esquema de Item de projeto do SharePoint.

  7. No Solution Explorer, com o botão direito do ItemTemplate do projeto, clique em Adde, em seguida, clique em Novo Item.

  8. No Add New Item caixa de diálogo, selecione Arquivo XML, tipo Elements na nome de campo e, em seguida, clique em Add.

  9. Substitua o conteúdo do arquivo elements XML com o XML a seguir, 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 de padrão que cria um item de menu no Ações do Site menu do site do SharePoint. Quando um usuário clica no item de menu, o URL especificado na UrlAction elemento é aberta 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.

  10. Opcionalmente, abra o arquivo ItemTemplate.ico e modificá-lo para que ele tenha um design que você possa reconhecer. Este ícone será exibido próximo ao item no projeto de Add New Item caixa de diálogo.

  11. Em Solution Explorer, com o botão direito do ItemTemplate de projeto e clique em Unload Project.

  12. Com o botão direito do ItemTemplate de projeto novamente e clique em ItemTemplate.csproj Editar ou Editar ItemTemplate.vbproj.

  13. Localize o seguinte VSTemplate o elemento no arquivo de projeto.

    <VSTemplate Include="ItemTemplate.vstemplate">

  14. Substituir VSTemplate elemento com o XML a seguir.

    <VSTemplate Include="ItemTemplate.vstemplate">
  <OutputSubPath>SharePoint\SharePoint14</OutputSubPath>
</VSTemplate>

    O OutputSubPath elemento Especifica as pastas adicionais no caminho em que o modelo de item é criado quando você constrói o projeto. As pastas especificadas aqui garantem que o modelo de item estará disponível somente quando os clientes cliquem o 2010 nó sob o SharePoint nó a Add New Item caixa de diálogo.

  15. Salve e feche o arquivo.

  16. Em Solution Explorer, com o botão direito do ItemTemplate de projeto e clique em Reload Project.

Criando um pacote VSIX para implantar o Item de projeto

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

Para configurar e criar o pacote VSIX

  1. Em Solution Explorer, clique duas vezes o source.extension.vsixmanifest arquivo no projeto CustomActionProjectItem.

    Visual Studio abre o arquivo no editor de manifesto. O arquivo source.extension.vsixmanifest é a base para o arquivo de extension.vsixmanifest é necessária para todos os pacotes VSIX. Para obter mais informações sobre este arquivo, consulte VSX Schema for Extensions.

  2. No Nome do produto , digite Item de projeto de ação personalizada.

  3. No Autor , digite Contoso.

  4. No Descrição , digite SharePoint de um item de projeto que representa uma ação personalizada.

  5. No conteúdo seção do editor, clique na Adicionar conteúdo botão.

  6. No Adicionar conteúdo na caixa de Selecione um tipo de conteúdo caixa de listagem, selecione Modelo de Item.

    ObservaçãoObservação

    Este valor corresponde do ItemTemplate elemento no arquivo extension.vsixmanifest. Esse elemento identifica a subpasta no pacote de VSIX que contém o modelo de item de projeto. Para obter mais informações, consulte ItemTemplate Element (VSX Schema).

  7. Em Selecionar uma fonte de, clique o projeto botão de opção e, em seguida, selecione ItemTemplate em que a caixa de listagem.

  8. Clique em OK.

  9. No editor de manifesto, clique na Adicionar conteúdo novamente.

  10. No Adicionar conteúdo na caixa de Selecione um tipo de conteúdo caixa de listagem, selecione MEF componente.

    ObservaçãoObservação

    Este valor corresponde do MefComponent elemento no arquivo extension.vsixmanifest. Este elemento Especifica o nome de um assembly de extensão no pacote VSIX. Para obter mais informações, consulte MEFComponent Element (VSX Schema).

  11. Em Selecionar uma fonte de, clique o projeto botão de opção e, em seguida, selecione ProjectItemDefinition em que a caixa de listagem.

  12. Clique em OK.

  13. Sobre o Build menu, clique em Build Solution. Certifique-se de que o projeto é compilado sem erros.

  14. Abra a pasta de saída de compilação do projeto CustomActionProjectItem. Certifique-se de que esta pasta agora contém o arquivo CustomActionProjectItem.vsix.

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

O Item de projeto de teste.

Agora você está pronto para testar o item de projeto. Primeiro, inicie a solução de CustomActionProjectItem na instância experimental do Visual Studio de depuração. Em seguida, testar o Ação personalizada item de projeto em um projeto do SharePoint na instância experimental do Visual Studio. Finalmente, construir e executar o projeto do SharePoint para verificar se a ação personalizada funciona como esperado.

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

  1. Reinicie o Visual Studio com privilégios de administrador e abra a solução de CustomActionProjectItem.

  2. Abra o arquivo de código CustomAction e adicionar um ponto de interrupção para a primeira linha do código de InitializeType método.

  3. Pressione F5 para iniciar a depuração.

    Visual Studio instala a extensão %UserProfile%\AppData\Local\Microsoft\VisualStudio\10.0Exp\Extensions\Contoso\Custom Item\1.0 de projeto de ação e inicia uma instância experimental do Visual Studio. Você testará o item de projeto nesta instância do Visual Studio.

Para testar o item de projeto em Visual Studio

  1. Na instância experimental do Visual Studio, sobre o arquivo , aponte para novae, em seguida, clique em projeto.

  2. Expanda Visual C# ou Visual Basic (dependendo do idioma que oferece suporte a seu modelo de item), expanda SharePointe em seguida, clique em 2010.

  3. Na lista de modelos de projeto, clique em Projeto vazio.

  4. No nome , digite CustomActionTest.

  5. Clique em OK.

  6. No O Assistente para personalização do SharePoint, digite a URL do site que você deseja usar para depuração e clique em Concluir.

  7. Em Solution Explorer, o botão direito do mouse no nó do projeto, aponte para Adde em seguida, clique em Novo Item.

  8. No Add New Item caixa de diálogo, clique no 2010 nó sob o SharePoint nó.

    Verifique o Ação personalizada item aparece na lista de itens de projeto.

  9. Clique em Ação personalizadae em seguida, clique em Add.

    Visual Studio adiciona um novo item chamado CustomAction1 ao seu projeto, e ele abre o arquivo elements XML no editor.

  10. Verificar que o código na instância de Visual Studio pára no ponto de interrupção que você definiu anteriormente na InitializeType método. Pressione F5 para continuar a depurar o projeto.

  11. Na instância experimental do Visual Studio, em Solution Explorer, com o botão direito do CustomAction1 nó e clique em View Designer de ação personalizada. Verifique se uma caixa de mensagem aparece e clique em OK.

    Você pode usar o menu de atalho para fornecer os comandos ou opções adicionais para desenvolvedores, como, por exemplo, exibindo um designer para a ação personalizada.

  12. Sobre o Exibir menu, clique em saída.

    A janela Output é aberta.

  13. Em Solution Explorer, com o botão direito do CustomAction1 item e altere o nome para MyCustomAction.

    Você verá uma mensagem de confirmação na saída janela esta mensagem é escrita pelo ProjectItemNameChanged manipulador de eventos que você definiu na CustomActionProjectItemTypeProvider classe. Você pode manipular esse evento e outros eventos de item de projeto para implementar o comportamento personalizado quando o desenvolvedor modifica o item de projeto.

Para testar a ação personalizada no SharePoint

  1. Na instância experimental do Visual Studio, abra o arquivo de elements que é filho de MyCustomAction o item de projeto.

  2. No arquivo elements, faça as seguintes alterações:

    • No CustomAction elemento, defina a Id atributo para uma GUID ou alguns outros exclusivo seqüência. Por exemplo:

      Id="cd85f6a7-af2e-44ab-885a-0c795b52121a"

    • No CustomAction elemento, defina a Title atributo da seguinte maneira:

      Title="SharePoint Developer Center"

    • No CustomAction elemento, defina a Description atributo da seguinte maneira:

      Description="Opens the SharePoint Developer Center Web site."

    • No UrlAction elemento, defina a Url atributo da seguinte maneira:

      Url="https://msdn.microsoft.com/sharepoint/default.aspx"

  3. Salve o arquivo elements.

  4. Pressione F5. A ação personalizada é empacotada e implantada no site do SharePoint especificado pelo URL do Site a propriedade do projeto. O navegador da Web abre para a página padrão deste site.

    ObservaçãoObservação

    Se o Desativado de depuração de Script caixa de diálogo é exibida, clique em Sim para continuar a depurar o projeto.

  5. Clique o Ações do Site menu. Verifique se que a ação personalizada denominada sharepoint Developer Center aparece na parte inferior do menu.

  6. Clique o sharepoint Developer Center o item de menu. Verifique se que o navegador abre o https://msdn.microsoft.com/sharepoint/default.aspx do site da Web.

  7. Feche o navegador da Web.

Limpando o computador de desenvolvimento

Após concluir o teste de item de projeto, remova o modelo de item de projeto da instância experimental do Visual Studio.

Para limpar o computador de desenvolvimento

  1. Na instância experimental do Visual Studio, sobre o Ferramentas menu, clique em Extension Manager.

    O Extension Manager abre a caixa de diálogo.

  2. Na lista de extensões, clique em Item de projeto de ação personalizadae em seguida, clique em desinstalar.

  3. Na caixa de diálogo que aparece, clique em Sim para confirmar que você deseja desinstalar a extensão.

  4. Clique em Reiniciar agora para concluir a desinstalação.

  5. Feche as duas instâncias de Visual Studio (a instância experimental e a instância do Visual Studio que abriu a solução de CustomActionProjectItem).

Próximas etapas

Depois de concluir este passo a passo, você pode adicionar um Assistente para o modelo de item. Quando um usuário adiciona um item de projeto de ação personalizada para um projeto do SharePoint, o assistente coleta informações sobre a ação personalizada (como, por exemplo, sua localização e a URL para navegar até quando é clicado) e adiciona essas informações ao arquivo elements no novo item de projeto. Para obter mais informações, consulte Demonstra Passo a passo: A criação de um Item de projeto de ação personalizada com um modelo de Item, parte 2.

Consulte também

Tarefas

Criando um novo Bitmap ou outra imagem

Referência

Referência de esquema de modelo do Studio Visual

Editor de imagens

Conceitos

Usando o serviço de projeto do SharePoint

Outros recursos

Demonstra Passo a passo: A criação de um Item de projeto de ação personalizada com um modelo de Item, parte 2

Definindo tipos de Item de projeto do SharePoint personalizados

Criando modelos de Item e projeto para os itens de projeto do SharePoint