Porady: tworzenie rozszerzenia elementu projektu SharePoint

Utwórz element projekt rozszerzenie , gdy chcesz dodać funkcje do elementu projekt do programu SharePoint, która jest już zainstalowana w Visual Studio.Aby uzyskać więcej informacji, zobacz Rozszerzanie pozycji projektu SharePoint.

Aby utworzyć projekt element rozszerzenie

1. Utwórz biblioteka klas projekt.

2. Dodaj odwołania do następujących zestawów:

   • Microsoft.VisualStudio.SharePoint

   • System.ComponentModel.Composition

3. Tworzenie klasy implementującej ISharePointProjectItemTypeExtension interfejs.

4. Do tej klasy należy dodać następujące atrybuty:

   • ExportAttribute.Ten atrybut pozwala Visual Studio odkryć i załadować your ISharePointProjectItemTypeExtension wdrożenia.Przekazać ISharePointProjectItemTypeExtension typu atrybutkonstruktor.

   • SharePointProjectItemTypeAttribute.Element projekt rozszerzenieten atrybut identyfikuje element projekt , który chcesz rozszerzyć.Identyfikator elementu projekt należy przekazać do atrybut konstruktor.Aby uzyskać listę identyfikatorów elementów projekt , które są dołączone do Visual Studio, zobacz Rozszerzanie pozycji projektu SharePoint.

5. W implementacji Initialize metoda, użyj członków projectItemType parametr definiują zachowanie programu rozszerzenie. Ten parametr jest ISharePointProjectItemType obiekt , który zapewnia dostęp do zdarzenia zdefiniowane w ISharePointProjectItemEvents i ISharePointProjectItemFileEvents interfejsów. Konkretne wystąpienie projekttyp elementu dostępu do powiększa się, dojście ISharePointProjectItemEvents zdarzenia, takie jak ProjectItemAdded i ProjectItemInitialized.

Przykład

Poniższy przykład kodu pokazuje jak utworzyć proste rozszerzenie elementu projekt odbiorcy zdarzeń.Przy każdym użytkownik dodaje element projekt odbiorca zdarzeń programu SharePoint projekt, to rozszerzenie pisze wiadomość do produkcji okno i Listy błędówokno.

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);
        }
    }
}

W tym przykładzie użyto usługi projekt programu SharePoint, aby napisać wiadomość do produkcji okno i Listy błędówokno. Aby uzyskać więcej informacji, zobacz Korzystanie z usługi projektu SharePoint.

Kompilowanie kodu

W tym przykładzie wymaga odwołania do następujących zestawów:

• Microsoft.VisualStudio.SharePoint

• System.ComponentModel.Composition

Wdrażanie rozszerzenia

wdrożyć rozszerzenie, utworzyć Visual Studio rozszerzenie (VSIX) pakiet dla zestaw i inne pliki, które chcesz rozproszony z rozszerzenie. Aby uzyskać więcej informacji, zobacz Wdrażanie rozszerzeń dla narzędzi SharePoint w Visual Studio.

Zobacz też

Zadania

Wskazówki: rozszerzanie typu elementu projektu SharePoint

Koncepcje

Rozszerzanie pozycji projektu SharePoint