Exemplarische Vorgehensweise: Hinzufügen einer Registerkarte zum Menüband für die Serverkomponente

Artikel
09/24/2014

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.

Siehe auch

Konzepte

Deklarative Anpassung des Menübands der Serverkomponente

Freigeben über