Erweitern von SharePoint-Projektelementen
Erstellen Sie eine Projektelementerweiterung, wenn Sie einem SharePoint-Projektelementtyp weitere Funktionen hinzufügen möchten, der in Visual Studio bereits installiert ist. Sie können in Visual Studio z. B. eine Erweiterung für die integrierten Projektelemente Ereignisempfänger oder Listendefinition erstellen, oder Sie können eine Erweiterung für einen benutzerdefinierten Projektelementtyp erstellen. Außerdem können Sie eine Erweiterung für alle Typen von SharePoint-Projektelementen erstellen.
Aufgaben beim Erweitern von SharePoint-Projektelementen
Um ein Projektelement zu erweitern, erstellen Sie eine Visual Studio-Erweiterungsassembly, die die ISharePointProjectItemTypeExtension-Schnittstelle implementiert. Weitere Informationen finden Sie unter Gewusst wie: Erstellen einer SharePoint-Projektelementerweiterung.
Wenn Sie ein Projektelement erweitern, können Sie dem Projektelement auch die folgende Funktionalität hinzufügen:
Fügen Sie dem Projektelement ein Kontextmenüelement hinzu. Das Menüelement wird angezeigt, wenn Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projektelement klicken. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen eines Kontextmenüelements zu einer SharePoint-Projektelementerweiterung.
Fügen Sie dem Projektelement eine benutzerdefinierte Eigenschaft hinzu. Diese Eigenschaft wird im Eigenschaftenfenster angezeigt, wenn Sie das Projektelement im Projektmappen-Explorer auswählen. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen einer Eigenschaft zu einer SharePoint-Projektelementerweiterung.
Eine exemplarische Vorgehensweise, die das Erstellen, Bereitstellen und Testen einer Projektelementerweiterung veranschaulicht, finden Sie unter Exemplarische Vorgehensweise: Erweitern eines SharePoint-Elementtyps.
Grundlegendes zur Beziehung zwischen Projektelementerweiterungen und Projektelementinstanzen
Während der Erstellung einer Projektelementerweiterung lädt Visual Studio die Erweiterung, wenn einem SharePoint-Projekt ein Projektelement des zugeordneten Typs hinzugefügt wird. Wenn Sie z. B. eine Erweiterung für Projektelemente vom Typ Ereignisempfänger erstellen, lädt Visual Studio die Erweiterung, wenn ein Benutzer einem Projekt ein Projektelement vom Typ Ereignisempfänger hinzufügt. Visual Studio verwendet die gleiche Instanz Ihrer Erweiterung für alle Instanzen des zugeordneten Projektelementtyps. Wenn der Benutzer dem Projekt im vorherigen Beispiel ein zweites Projektelement vom Typ Ereignisempfänger hinzufügt, wird die gleiche Instanz der Erweiterung verwendet, um das zweite Projektelement anzupassen.
Um auf eine bestimmte Instanz des erweiterten Projektelementtyps zuzugreifen, behandeln Sie eines der ISharePointProjectItemEvents-Ereignisse des projectItemType-Parameters in der Implementierung der ISharePointProjectItemTypeExtension.Initialize-Methode. Wenn Sie z. B. festlegen möchten, wann ein Projektelement des Typs, für den Sie eine Erweiterung eingerichtet haben, einem Projekt hinzugefügt wird, behandeln Sie das ProjectItemAdded-Ereignis. Weitere Informationen finden Sie unter Gewusst wie: Erstellen einer SharePoint-Projektelementerweiterung.
Bezeichner für SharePoint-Projektelemente
Jedes SharePoint-Projektelement verfügt über einen zugehörigen Zeichenfolgenbezeichner. Sie müssen den Bezeichner für ein Projektelement kennen, wenn Sie die folgenden Aufgaben ausführen möchten:
Erstellen einer Erweiterung für das Projektelement. In diesem Fall müssen Sie den Bezeichner für das Projektelement, das Sie erweitern möchten, an den Konstruktor von SharePointProjectItemTypeAttribute übergeben. Um eine Erweiterung für alle Projektelementtypen zu erstellen, übergeben Sie den Zeichenfolgenwert *.
Programmgesteuertes Hinzufügen eines Projektelements zu einem Projekt. In diesem Fall müssen Sie den Bezeichner für das Projektelement an die ISharePointProjectItemCollection.Add-Methode übergeben.
In der folgenden Tabelle sind die Bezeichner für die in Visual Studio 2010 enthaltenen SharePoint-Projektelemente aufgeführt.
Projektelementname |
Zeichenfolgenbezeichner |
---|---|
Geschäftsdatenkatalogmodell |
Microsoft.VisualStudio.SharePoint.BusinessDataConnectivity |
Inhaltstyp |
Microsoft.VisualStudio.SharePoint.ContentType |
Ereignisempfänger |
Microsoft.VisualStudio.SharePoint.EventHandler |
Leeres Element |
Microsoft.VisualStudio.SharePoint.GenericElement |
Listendefinition Listendefinition aus Inhaltstyp |
Microsoft.VisualStudio.SharePoint.ListDefinition |
Listeninstanz |
Microsoft.VisualStudio.SharePoint.ListInstance |
Modul |
Microsoft.VisualStudio.SharePoint.Module |
Sequenzieller Workflow Zustandsautomatworkflow |
Microsoft.VisualStudio.SharePoint.Workflow |
Websitedefinition |
Microsoft.VisualStudio.SharePoint.SiteDefinition |
Visuelles Webpart |
Microsoft.VisualStudio.SharePoint.VisualWebPart |
Webpart |
Microsoft.VisualStudio.SharePoint.WebPart |
Workflowzuordnungsformular |
Microsoft.VisualStudio.SharePoint.WorkflowAssociation |
Siehe auch
Aufgaben
Gewusst wie: Erstellen einer SharePoint-Projektelementerweiterung
Exemplarische Vorgehensweise: Erweitern eines SharePoint-Elementtyps
Konzepte
Erweitern des SharePoint-Projektsystems
Weitere Ressourcen
Gewusst wie: Hinzufügen eines Kontextmenüelements zu einer SharePoint-Projektelementerweiterung
Gewusst wie: Hinzufügen einer Eigenschaft zu einer SharePoint-Projektelementerweiterung