Exemplarische Vorgehensweise: Ersetzen einer Schaltfläche auf dem Menüband für die Serverkomponente für eine Websitesammlung

Artikel
09/24/2014

Letzte Änderung: Freitag, 4. 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 dargestellt, wie eine Schaltfläche auf dem Menüband für die Serverkomponente in Microsoft SharePoint Foundation auf Ebene der Websitesammlung ersetzt wird. Verwenden Sie eine benutzerdefinierte Aktion in Verbindung mit dem ScriptLink-Speicherort, um das ECMAScript (JavaScript, JScript) auf allen Seiten hinzuzufügen.

Voraussetzungen

Microsoft SharePoint Foundation 2010

SharePoint-Entwicklungstools in Microsoft Visual Studio 2010

Erstellen eines SharePoint-Projekts

Um das Menüband anzupassen, erstellen Sie zunächst ein leeres SharePoint-Projekt.

So erstellen Sie ein SharePoint-Projekt

Starten Sie Microsoft Visual Studio 2010.
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Wählen Sie in Projekttypen die Option C# und dann Leeres SharePoint-Projekt aus.
Geben Sie ReplaceARibbonButtonUsingScriptLink als Projektnamen ein, und klicken Sie auf OK.
Wählen Sie im Assistenten zum Anpassen von SharePoint Als Farmlö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 den Titeldes Features in Ersetzen einer Menübandschaltfläche mithilfe von ScriptLink.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Feature1, und wählen Sie Umbenennen aus. Geben Sie ReplaceARibbonButtonUsingScriptLink als neuen Namen ein.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt ReplaceARibbonButtonUsingScriptLink, zeigen Sie auf Hinzufügen, und wählen Sie dann Neues Element aus.
Wählen Sie im Dialogfeld Neues Element hinzufügen die Vorlage Leeres Element aus. Geben Sie ReplaceARibbonButtonUsingScriptLink als Namen ein.

Definieren der benutzerdefinierten Aktion

Die Menübandschaltfläche wird mithilfe des Location-Attributs des CommandUIDefinition-Elements ersetzt. Die Standardwerte für Menübandschaltflächen sind unter 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

Öffnen Sie die Datei Elements.xml.

Kopieren Sie den folgenden XML-Code, und fügen Sie ihn 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 Bild-URLs ersetzen.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <CustomAction Id="Ribbon.Library.Actions.ConnectToClient"
    Location="CommandUI.Ribbon"
    RegistrationId="101"
    RegistrationType="List"
    Title="Custom ECMAScript Button">
    <CommandUIExtension>
      <CommandUIDefinitions>
        <CommandUIDefinition
          Location="Ribbon.Library.Actions.ConnectToClient">
          <Button Id="Ribbon.Library.Actions.ConnectToClient"
            Command="CustomECMAScriptCommand"
            Image16by16="Insert an image URL here."
            Image32by32="Insert an image URL here."
            LabelText="Hello World"
            TemplateAlias="o1" />
        </CommandUIDefinition>
      </CommandUIDefinitions>
      <CommandUIHandlers>
        <CommandUIHandler
          Command="CustomECMAScriptCommand"
          CommandAction="javascript:HelloWorld();" />
      </CommandUIHandlers>
    </CommandUIExtension>
  </CustomAction>
  <CustomAction Id="Ribbon.Library.Actions.NewButton.Script"
    Location="ScriptLink"
    ScriptBlock="
    function HelloWorld()
    {
      alert('Hello, world!');
    }" />
</Elements>

Bereitstellen der Anpassung

Da das Projekt als Farmlösung eingerichtet wurde, wird es automatisch bereitgestellt und Internetinformationsdienste (Internet Information Services, IIS) wird zurückgesetzt.

So stellen Sie die Anpassung bereit

Drücken Sie F5. Die SharePoint-Entwicklungstools in Visual Studio 2010 erstellen das Feature automatisch und stellen es bereit.
Navigieren Sie zu einer Dokumentbibliothek in Ihrer Website oder Unterwebsite.
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.