Exemplarische Vorgehensweise: Hinzufügen einer Registerkarte zum Menüband für die Serverkomponente
Letzte Änderung: Montag, 7. Februar 2011
Gilt für: SharePoint Foundation 2010
Inhalt dieses Artikels
Erstellen eines SharePoint-Projekts
Hinzufügen eines neuen Features
Definieren der benutzerdefinierten Aktion
Bereitstellen der Anpassung
In diesem Thema wird erläutert, wie Sie dem Menüband für die Serverkomponente in Microsoft SharePoint Foundation eine neue Registerkarte hinzufügen.
Voraussetzungen
SharePoint Foundation 2010
SharePoint-Entwicklungstools in Microsoft Visual Studio 2010
Erstellen eines SharePoint-Projekts
Zum Hinzufügen einer neuen Registerkarte erstellen Sie zunächst ein leeres SharePoint-Projekt.
So erstellen Sie ein SharePoint-Projekt
Starten Sie Visual Studio 2010.
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Wählen Sie in Projekttypen unter Visual Basic oder C# die Option Leeres SharePoint-Projekt aus.
Geben Sie AddARibbonTab als Projektnamen ein, und klicken Sie auf OK.
Wählen Sie im Assistenten zum Anpassen von SharePoint Als Sandkastenlösung bereitstellen aus, und klicken Sie dann auf Fertig stellen.
Hinzufügen eines neuen Features
Sie können das Menüband mithilfe eines Features anpassen. Mit den folgenden Schritten fügen Sie der Lösung ein neues Feature hinzu.
So fügen Sie ein neues Feature hinzu
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Features, und wählen Sie Funktion hinzufügen aus.
Ändern Sie das Feld Titel des Features in Custom Ribbon Tab.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Feature1, und wählen Sie Umbenennen aus. Geben Sie CustomRibbonTab als neuen Namen ein.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt AddARibbonTab, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Neues Element.
Wählen Sie im Dialogfeld Neues Element hinzufügen die Vorlage Leeres Element aus. Geben Sie CustomRibbonTab als Namen ein.
Definieren der benutzerdefinierten Aktion
Die Anpassung des Menübands wird mithilfe von Menüband-XML in einer benutzerdefinierten Aktion definiert. Eine ausführliche Erläuterung der Menüband-XML finden Sie unter XML für das Menüband für die Serverkomponente.
So definieren Sie die benutzerdefinierte Aktion
Öffnen Sie die Datei Elements.xml.
Kopieren Sie die folgende Menüband-XML, und fügen Sie sie in die Datei Elements.xml ein. Dadurch wird eine neue Registerkarte My Custom Tab mit einer Gruppe und drei Schaltflächen in einer Dokumentbibliothek hinzugefügt.
<?xml version="1.0" encoding="utf-8"?> <Elements xmlns="https://schemas.microsoft.com/sharepoint/"> <CustomAction Id="MyCustomRibbonTab" Location="CommandUI.Ribbon.ListView" RegistrationId="101" RegistrationType="List"> <CommandUIExtension> <CommandUIDefinitions> <CommandUIDefinition Location="Ribbon.Tabs._children"> <Tab Id="Ribbon.CustomTabExample" Title="My Custom Tab" Description="This holds my custom commands!" Sequence="501"> <Scaling Id="Ribbon.CustomTabExample.Scaling"> <MaxSize Id="Ribbon.CustomTabExample.MaxSize" GroupId="Ribbon.CustomTabExample.CustomGroupExample" Size="OneLargeTwoMedium"/> <Scale Id="Ribbon.CustomTabExample.Scaling.CustomTabScaling" GroupId="Ribbon.CustomTabExample.CustomGroupExample" Size="OneLargeTwoMedium" /> </Scaling> <Groups Id="Ribbon.CustomTabExample.Groups"> <Group Id="Ribbon.CustomTabExample.CustomGroupExample" Description="This is a custom group!" Title="Custom Group" Sequence="52" Template="Ribbon.Templates.CustomTemplateExample"> <Controls Id="Ribbon.CustomTabExample.CustomGroupExample.Controls"> <Button Id="Ribbon.CustomTabExample.CustomGroupExample.HelloWorld" Command="CustomTabExample.HelloWorldCommand" Sequence="15" Description="Says hello to the World!" LabelText="Hello, World!" TemplateAlias="cust1"/> <Button Id="Ribbon.CustomTabExample.CustomGroupExample.GoodbyeWorld" Command="CustomTabExample.GoodbyeWorldCommand" Sequence="17" Description="Says good-bye to the World!" LabelText="Good-bye, World!" TemplateAlias="cust2"/> <Button Id="Ribbon.CustomTabExample.CustomGroupExample.LoveWorld" Command="CustomTabExample.LoveWorldCommand" Sequence="19" Description="Says I love the World!" LabelText="I love you, World!" TemplateAlias="cust3"/> </Controls> </Group> </Groups> </Tab> </CommandUIDefinition> <CommandUIDefinition Location="Ribbon.Templates._children"> <GroupTemplate Id="Ribbon.Templates.CustomTemplateExample"> <Layout Title="OneLargeTwoMedium" LayoutTitle="OneLargeTwoMedium"> <Section Alignment="Top" Type="OneRow"> <Row> <ControlRef DisplayMode="Large" TemplateAlias="cust1" /> </Row> </Section> <Section Alignment="Top" Type="TwoRow"> <Row> <ControlRef DisplayMode="Medium" TemplateAlias="cust2" /> </Row> <Row> <ControlRef DisplayMode="Medium" TemplateAlias="cust3" /> </Row> </Section> </Layout> </GroupTemplate> </CommandUIDefinition> </CommandUIDefinitions> <CommandUIHandlers> <CommandUIHandler Command="CustomTabExample.HelloWorldCommand" CommandAction="javascript:alert('Hello, world!');" /> <CommandUIHandler Command="CustomTabExample.GoodbyeWorldCommand" CommandAction="javascript:alert('Good-bye, world!');" /> <CommandUIHandler Command="CustomTabExample.LoveWorldCommand" CommandAction="javascript:alert('I love you, world!');" /> </CommandUIHandlers> </CommandUIExtension> </CustomAction> </Elements>
Bereitstellen der Anpassung
Da das Projekt als Lösung mit eingeschränkter Sicherheitsstufe eingerichtet wurde, wird es im Lösungskatalog bereitgestellt.
So stellen Sie die Anpassung bereit
Drücken Sie F5. Das Feature wird von den SharePoint-Entwicklungstools in Visual Studio 2010 automatisch erstellt und bereitgestellt.
Wechseln Sie zu einer Dokumentbibliothek auf der Website oder Unterwebsite.
Klicken Sie auf die Registerkarte My Custom Tab, beachten Sie die benutzerdefinierte Gruppe, und klicken Sie auf eine der Schaltflächen Hello, World, Good-bye, World oder I Love You, World.