Schritt 2: Erstellen des ECB-Menüelements
Letzte Änderung: Dienstag, 6. April 2010
Gilt für: SharePoint Server 2010
In diesem Thema wird gezeigt, wie Sie das Listenelement-Kontextmenü ändern, das auch als ECB-Menü (Edit Control Block, Bearbeitungskontrollblock) bezeichnet wird, und ein Element hinzufügen, mit dem der Dokumentkonvertierungsauftrag von Word-Automatisierungsdienste initiiert wird.
Hinzufügen des ECB-Menüelements
Mit der in dieser exemplarischen Vorgehensweise erstellten Lösung wird ein Eintrag im Listenelement-Kontextmenü für Microsoft Word-DOCX-Dateien erstellt. Wenn Benutzer das Kontextmenü des Dokuments für eine DOCX-Datei öffnen, können sie auf den neuen Eintrag klicken, um die Konvertierung des Dokuments zu initiieren. Wenn Sie das ECB-Menü ändern möchten, erstellen Sie ein neues Feature und fügen ein neues Kontextmenüelement hinzu.
So erstellen Sie ein Feature
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Features, und klicken Sie dann auf Feature hinzufügen.
Geben Sie einen Titel für das Feature ein, wie z. B. Convert Document.
Geben Sie eine Beschreibung für das Feature ein, wie z. B. This feature converts Word Open XML documents by using Word Automation Services.
Übernehmen Sie den Standardfeaturebereich Web, womit die SharePoint Server 2010-Farmadministratoren das Feature für jede Website einzeln aktivieren bzw. deaktivieren können.
Nachdem Sie das Feature erstellt haben, fügen Sie das neue Kontextmenüelement hinzu.
So fügen Sie ein Kontextmenüelement hinzu
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, zeigen Sie auf Hinzufügen und klicken Sie dann auf Neues Element.
Wählen Sie im Dialogfeld Neues Element hinzufügen die Option Leeres Element aus, um eine leere Elementdatei zu erstellen, in der Sie den XML-Code zur Definition des Kontextmenüelements hinzufügen können.
Geben Sie einen Namen für das Element ein, wie z. B. ContextMenuItem.
Klicken Sie auf Hinzufügen, um dem Projekt das Element hinzuzufügen. Das neue Element wird im Projektmappen-Explorer angezeigt.
Doppelklicken Sie im Projektmappen-Explorer auf die Datei Elements.xml, um sie zum Bearbeiten zu öffnen.
Fügen Sie im XML-Code für die Datei Elements.xml im <Elements>-Element den folgenden XML-Code hinzu.
<CustomAction Id="ConvertDocument" RegistrationType="FileType" RegistrationId="docx" Location="EditControlBlock" Sequence="106" Title="Convert Document"></CustomAction>Der XML-Code definiert die neue benutzerdefinierte Dokumentkonvertierungsaktion durch Festlegen der folgenden Attribute:
Id gibt eine beliebige eindeutige ID für diese Aktion an; in diesem Fall ConvertDocument.
RegistrationType gibt an, wann dieses Kontextmenüelement angezeigt wird. In diesem Fall geben Sie mit FileType an, dass das neue Kontextmenüelement einer bestimmten Dateinamenerweiterung zugeordnet ist.
RegistrationId gibt den Dateityp an, der für dieses Kontextmenüelement verwendet werden soll. In diesem Fall begrenzen Sie mit docx das Menüelement auf Dateien mit der Dateinamenerweiterung DOCX.
Location gibt an, wo das Menüelement hinzugefügt werden soll. In diesem Fall platzieren Sie mit EditControlBlock diese Aktion im Listenelement-Kontextmenü.
Sequence gibt an, wo das Element in Bezug auf die anderen Elemente im Menü angezeigt wird.
Title gibt den Namen des benutzerdefinierten Menüelements an, wie z. B. ConvertDocument.
Fügen Sie im <CustomAction>-Element den folgenden XML-Code hinzu.
<UrlAction Url="~site/_layouts/ConvertItem/ConvertItem.aspx?ListId={ListId}&ItemId={ItemId}&ItemUrl={ItemUrl}"/>Der XML-Code definiert eine URL zu einer SharePoint-Webseite, die geöffnet wird, wenn der Benutzer diese benutzerdefinierte Aktion aufruft. Die URL beginnt mit ~site/, was in die URL der aktuellen SharePoint Server 2010-Website aufgelöst wird. Die URL enthält außerdem drei Abfrageparameter und die zugehörigen Token:
{ListId}, was in die ID der übergeordneten Liste aufgelöst wird.
{ItemId}, was in die ID des Listenelements aufgelöst wird.
{ItemUrl}, was in die URL relativ zur Website des Listenelements aufgelöst wird.
Siehe auch
Aufgaben
Schritt 1: Einrichten des Visual Studio 2010-Projekts für die ECB-Menüelement-Lösung
Schritt 3: Erstellen einer Webanwendungsseite zum Starten von Konvertierungen
Schritt 4: Erstellen einer Webanwendungsseite zum Überwachen von Konvertierungen
Schritt 5: Erstellen und Bereitstellen der ECB-Menü-Lösung