Postupy: Vytváření rozšíření položky projektu SharePoint

Vytvořte rozšíření položky projektu tehdy, chcete-li přidávat funkce do položky projektu služby SharePoint, který je již nainstalován v aplikaci Visual Studio.Další informace naleznete v tématu Rozšíření položek projektu služby SharePoint.

Chcete-li vytvořit rozšíření položky projektu

1. Vytvořte projekt knihovny tříd.

2. Přidejte odkazy do následujících sestavení:

   • Microsoft.VisualStudio.SharePoint

   • System.ComponentModel.Composition

3. Vytvořte třídu, která implementuje rozhraní ISharePointProjectItemTypeExtension.

4. Přidejte následující atributy do třídy:

   • ExportAttribute.Tento atribut umožňuje Visual Studiu zjišťovat a načítat vaši implementaci ISharePointProjectItemTypeExtension.Předejte ISharePointProjectItemTypeExtension typ do konstruktoru atributu.

   • SharePointProjectItemTypeAttribute.V rozšíření položky projektu identifikuje tento atribut položku projektu, kterou chcete rozšířit.Předat ID položky projektu do konstruktoru atributu.Seznam identifikátorů položek projekt , které jsou součástí Visual Studio, viz Rozšíření položek projektu služby SharePoint.

5. Vaše implementace metody Initialize užívá členy parametru projectItemType pro definování chování vašeho rozšíření.Tento parametr je objekt ISharePointProjectItemType, který poskytuje přístup k událostem definovaným v rozhraní ISharePointProjectItemEvents a ISharePointProjectItemFileEvents.Chcete-li získat přístup k určité instanci typu položky projektu, kterou rozšiřujete, zpracovávejte události ISharePointProjectItemEvents, jako jsou například ProjectItemAdded a ProjectItemInitialized.

Příklad

Následující příklad kódu ukazuje, jak vytvořit jednoduché rozšíření pro položku projektu přijímače události.Pokaždé, když uživatel přidá do projektu SharePoint přijímač události položky projektu, toto rozšíření zapíše zprávu do okna Výstup a do okna Seznam chyb.

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

Namespace Contoso.ExampleProjectItemExtension

    <Export(GetType(ISharePointProjectItemTypeExtension))> _
    <SharePointProjectItemType("Microsoft.VisualStudio.SharePoint.EventHandler")> _
    Friend Class ExampleProjectItemExtension
        Implements ISharePointProjectItemTypeExtension

        Private Sub Initialize(ByVal projectItemType As ISharePointProjectItemType) _
            Implements ISharePointProjectItemTypeExtension.Initialize
            AddHandler projectItemType.ProjectItemAdded, AddressOf ProjectItemAdded
        End Sub 

        Private Sub ProjectItemAdded(ByVal Sender As Object, ByVal e As SharePointProjectItemEventArgs)
            Dim projectItem As ISharePointProjectItem = CType(Sender, ISharePointProjectItem)
            Dim Message As String = String.Format("An Event Handler project item named {0} was added to the {1} project.", _
                projectItem.Name, projectItem.Project.Name)
            projectItem.Project.ProjectService.Logger.WriteLine(Message, LogCategory.Message)
        End Sub 
    End Class 
End Namespace

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

namespace Contoso.ExampleProjectItemExtension
{
    [Export(typeof(ISharePointProjectItemTypeExtension))]
    [SharePointProjectItemType("Microsoft.VisualStudio.SharePoint.EventHandler")]
    internal class ExampleProjectItemExtension : ISharePointProjectItemTypeExtension
    {
        public void Initialize(ISharePointProjectItemType projectItemType)
        {
            projectItemType.ProjectItemAdded += projectItemType_ProjectItemAdded;
        }

        void projectItemType_ProjectItemAdded(object sender, SharePointProjectItemEventArgs e)
        {
            ISharePointProjectItem projectItem = (ISharePointProjectItem)sender;
            string message = String.Format("An Event Handler project item named {0} was added to the {1} project.",
                projectItem.Name, projectItem.Project.Name);
            projectItem.Project.ProjectService.Logger.WriteLine(message, LogCategory.Message);
        }
    }
}

V tomto příkladu je pomocí projektu služby SharePoint zapsána zpráva do okna Výstup a do okna Seznam chyb.Další informace naleznete v tématu Použití služby projektu služby SharePoint.

Probíhá kompilace kódu

Tento příklad vyžaduje odkazy na následující sestavení:

• Microsoft.VisualStudio.SharePoint

• System.ComponentModel.Composition

Nasazování rozšíření

Chcete-li nasadit rozšíření, vytvořte Visual Studio balíček rozšíření (VSIX) pro sestavení a všechny další soubory, které chcete distribuovat s rozšířením.Další informace naleznete v tématu Nasazování rozšíření pro nástroje služby SharePoint v aplikaci Visual Studio.

Viz také

Úkoly

Návod: Rozšiřování typu položky projektu SharePoint

Koncepty

Rozšíření položek projektu služby SharePoint