Exemplarische Vorgehensweise: Ersetzen einer Schaltfläche auf dem 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 Ersetzen einer Schaltfläche auf dem 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 Anpassen des Menübands 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ächeErsetzen als Projektnamen ein, und klicken Sie dann 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 Menübandschaltfläche ersetzen.

3. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Feature1, und wählen Sie dann Umbenennen aus. Geben Sie MenübandschaltflächeErsetzen als neuen Projektnamen ein.

4. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt MenübandschaltflächeErsetzen, 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 MenübandschaltflächeErsetzen als Namen ein.

Definieren der benutzerdefinierten Aktion

Ersetzen Sie die Menübandschaltfläche mithilfe des Location-Attributs des CommandUIDefinition-Elements. Die Standardwerte für Menübandschaltflächen sind in Anpassen von Standardobjekten im Menüband der Serverkomponente aufgeführt. 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. Dieser XML-Code ersetzt die Schaltfläche Verbindung mit Outlook herstellen auf der Registerkarte Bibliothek in der Gruppe Verbinden und exportieren für eine Dokumentbibliothek.

   Wichtig
   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.ReplacementButton"
       Location="CommandUI.Ribbon"
       RegistrationId="101"
       RegistrationType="List"
       Title="Replace a Ribbon Button">
       <CommandUIExtension>
         <CommandUIDefinitions>
           <CommandUIDefinition
             Location="Ribbon.Library.Actions.ConnectToClient">
                <Button Id="Ribbon.Library.Actions.ConnectToClient.ReplacementButton"
                  Command="ReplacementButtonCommand"
                  Image16by16="Insert an image URL here."
                  Image32by32="Insert an image URL here."
                  LabelText="Replaced Button"
                  TemplateAlias="o2" />
           </CommandUIDefinition>
         </CommandUIDefinitions>
         <CommandUIHandlers>
           <CommandUIHandler
             Command="ReplacementButtonCommand"
             CommandAction="javascript:alert('This button has been replaced.');" />
         </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. Wenn Sie auf die Registerkarte Bibliothek klicken und in der Gruppe Verbinden und exportieren nachsehen, erkennen Sie, dass die Schaltfläche Verbindung mit Outlook herstellen fehlt.

Siehe auch

Aufgaben

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

Konzepte

Deklarative Anpassung des Menübands der Serverkomponente