Definieren von benutzerdefinierten SharePoint-Projektelementtypen

Artikel
02/20/2013

Definieren Sie einen neuen SharePoint-Projektelementtyp, wenn Sie eine neue Art von SharePoint-Projektelement erstellen möchten.Visual Studio enthält z. B. keine SharePoint-Projektelemente zum Hinzufügen von Feldern oder benutzerdefinierten Aktionen zu einer SharePoint-Website.Sie können eigene Typen von SharePoint-Projektelementen definieren, um Felder, benutzerdefinierte Aktionen oder sonstige Typen von SharePoint-Komponenten zu erstellen.

Aufgaben beim Definieren von SharePoint-Projektelementtypen

Um einen benutzerdefinierten Projektelementtyp zu definieren, erstellen Sie eine Visual Studio-Erweiterungsassembly, die die ISharePointProjectItemTypeProvider-Schnittstelle implementiert.Weitere Informationen finden Sie unter Gewusst wie: Definieren eines SharePoint-Projektelementtyps.

Wenn Sie einen benutzerdefinierten Projektelementtyp definieren, 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 das Kontextmenü für das Projektelement in Projektmappen-Explorer öffnen, indem Sie auf das Projektelement mit der rechten Maustaste klicken oder indem Sie sie auswählen und dann die UMSCHALT+F10-Tasten auswählen.Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen eines Kontextmenüelements zu einem benutzerdefinierten SharePoint-Projektelementtyp.
Fügen Sie dem Projektelement eine benutzerdefinierte Eigenschaft hinzu.Die Eigenschaft wird im Eigenschaften angezeigt, wenn Sie das Projektelement in Projektmappen-Explorer auswählen.Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen einer Eigenschaft zu einem benutzerdefinierten SharePoint-Projektelementtyp.

Um anderen Entwicklern die Verwendung Ihres Projektelements in Visual Studio zu ermöglichen, erstellen Sie eine SPDATA-Datei und eine Elementvorlage oder eine Projektvorlage, die dem Projektelement zugeordnet ist.Weitere Informationen finden Sie unter Erstellen von Elementvorlagen und Projektvorlagen für SharePoint-Projektelemente.

Grundlegendes zur Beziehung zwischen Projektelementtypen und Projektelementinstanzen

Während der Definition eines SharePoint-Projektelementtyps lädt Visual Studio die Erweiterung, wenn einem SharePoint-Projekt ein Projektelement des zugeordneten Typs hinzugefügt wird.Wenn Sie z. B. einen neuen Projektelementtyp Benutzerdefinierte Aktion definieren, lädt Visual Studio die Erweiterung, wenn ein Benutzer einem Projekt ein Projektelement vom Typ Benutzerdefinierte Aktion 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 Benutzerdefinierte Aktion hinzufügt, wird die gleiche Instanz der Erweiterung verwendet, um das zweite Projektelement anzupassen.

Um auf eine bestimmte Instanz des Projektelementtyps zuzugreifen, behandeln Sie eines der ISharePointProjectItemEvents-Ereignisse des projectItemTypeDefinition-Parameters in der Implementierung der ISharePointProjectItemTypeProvider.InitializeType-Methode.Um z. B. zu bestimmen, wann einem Projekt ein Projektelement des benutzerdefinierten Typs hinzugefügt wird, behandeln Sie das ProjectItemAdded-Ereignis.Weitere Informationen finden Sie unter Gewusst wie: Definieren eines SharePoint-Projektelementtyps.