Freigeben über


Exemplarische Vorgehensweise: Hinzufügen einer Schaltfläche zum Servermenüband

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 das Hinzufügen einer neuen Schaltfläche zum Menüband für die Serverkomponente in Microsoft SharePoint Foundation beschrieben.

Voraussetzungen

Microsoft SharePoint Foundation 2010

SharePoint-Entwicklungstools in Microsoft Visual Studio 2010

Erstellen eines SharePoint-Projekts

Zum Hinzufügen einer neuen Schaltfläche erstellen Sie zunächst ein leeres SharePoint-Projekt.

So erstellen Sie ein SharePoint-Projekt

  1. Starten Sie Microsoft Visual Studio 2010.

  2. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

  3. Wählen Sie in Projekttypen unter Visual Basic oder C# die Option Leeres SharePoint-Projekt aus.

  4. Geben Sie MenübandschaltflächeHinzufügen als Projektnamen ein. Klicken Sie auf OK.

  5. Wählen Sie im Assistenten zum Anpassen von SharePoint die Option Als Sandkastenlösung bereitstellen aus, und klicken Sie dann auf Fertig stellen.

Hinzufügen eines neuen Features

Das Menüband kann mithilfe eines Features angepasst werden. Mit den folgenden Schritten wird der Lösung ein neues Feature hinzugefügt.

So fügen Sie ein neues Feature hinzu

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Features, und klicken Sie dann auf Feature hinzufügen.

  2. Ändern Sie die Angaben im Feld Titel des Features in Benutzerdefinierte Menübandschaltfläche.

  3. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Feature1, und klicken Sie dann auf Umbenennen. Geben Sie BenutzerdefinierteMenübandschaltfläche als neuen Projektnamen ein.

  4. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt MenübandschaltflächeHinzufügen, zeigen Sie auf Hinzufügen, und wählen Sie dann Neues Element aus.

  5. Wählen Sie im Dialogfeld Neues Element hinzufügen die Vorlage Leeres Element aus. Geben Sie BenutzerdefinierteMenübandschaltfläche als Namen ein.

Definieren der benutzerdefinierten Aktion

Sie definieren die Menübandschaltfläche mithilfe von Menüband-XML in einer benutzerdefinierten Aktion. Eine ausführliche Erläuterung zum XML des Menübands finden Sie unter XML für das Menüband für die Serverkomponente.

So definieren Sie die benutzerdefinierte Aktion

  1. Öffnen Sie die Datei Elements.xml.

  2. Fügen Sie den folgenden XML-Code in die Datei Elements.xml ein. Mit diesem XML-Code wird eine neue Schaltfläche auf der Registerkarte Bibliothek in der Gruppe Freigeben und verfolgen für eine Dokumentbibliothek erstellt.

    Wichtiger HinweisWichtig

    Sie müssen die Attribute Image32by32 und Image16by16 durch gültige Abbild-URLs ersetzen.

    <?xml version="1.0" encoding="utf-8"?>
    <Elements xmlns="https://schemas.microsoft.com/sharepoint/">
      <CustomAction 
        Id="Ribbon.Library.Actions.AddAButton"
        Location="CommandUI.Ribbon"
        RegistrationId="101"
        RegistrationType="List"
        Title="Add a Ribbon Button">
        <CommandUIExtension>
          <CommandUIDefinitions>
            <CommandUIDefinition
              Location="Ribbon.Library.Share.Controls._children">
              <Button Id="Ribbon.Library.Share.NewRibbonButton"
                Command="NewRibbonButtonCommand"
                Image16by16="Insert an image URL here."
                Image32by32="Insert an image URL here."
                LabelText="Hello World"
                TemplateAlias="o2" />
            </CommandUIDefinition>
          </CommandUIDefinitions>
          <CommandUIHandlers>
            <CommandUIHandler 
              Command="NewRibbonButtonCommand"
              CommandAction="javascript:alert('Hello, 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

  1. Drücken Sie F5. Das Feature wird von den SharePoint-Entwicklungstools in Visual Studio 2010 automatisch erstellt und bereitgestellt.

  2. Wechseln Sie zu einer Dokumentbibliothek auf der Website oder Unterwebsite.

  3. Klicken Sie auf die Registerkarte Bibliothek, sehen Sie sich die Gruppe Freigeben und verfolgen an, und klicken Sie auf die Schaltfläche Hello World.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Entfernen einer Schaltfläche vom Servermenüband

Konzepte

Deklarative Anpassung des Menübands der Serverkomponente