Пошаговое руководство. Замена кнопки на ленте сервера для семейства веб-сайтов

Дата последнего изменения: 4 февраля 2011 г.

Применимо к: SharePoint Foundation 2010

В этой статье
Создание проекта SharePoint
Добавление нового компонента
Задание настраиваемого действия
Развертывание настройки

В этом разделе демонстрируется замена кнопки в сервера для уровня семейства узлов Microsoft SharePoint Foundation. Будет использовано настраиваемое действие с расположением ScriptLink, позволяющее добавить ECMAScript (JavaScript, JScript) на все страницы.

Необходимые компоненты

Microsoft SharePoint Foundation 2010

разработки SharePoint в Microsoft Visual Studio 2010

Создание проекта SharePoint

Настройка ленты начинается с создания пустого проекта SharePoint.

Создание проекта SharePoint

  1. Запустите Microsoft Visual Studio 2010.

  2. В меню Файл выберите пункт Создать, а затем выберите Проект.

  3. В списке Типы проектов последовательно выберите элементы C# и Пустой проект SharePoint.

  4. Введите ReplaceARibbonButtonUsingScriptLink в качестве имени проекта и нажмите кнопку ОК.

  5. В окне Мастер настройки SharePoint выберите пункт Развернуть как решение фермы и нажмите кнопку Готово.

Добавление нового компонента

Ленту можно настраивать, добавляя на нее новые компоненты. Ниже приведены инструкции по добавлению в решение нового компонента.

Добавление компонента

  1. В окне Обозреватель решений щелкните правой кнопкой мыши элемент Компоненты и выберите команду Добавить компонент.

  2. Измените Название компонента на Замена кнопки ленты с помощью ScriptLink.

  3. Щелкните правой кнопкой мыши Feature1 в окне Обозреватель решений и выберите команду Переименовать. Введите ReplaceARibbonButtonUsingScriptLink в качестве нового имени.

  4. Щелкните правой кнопкой мыши проект ReplaceARibbonButtonUsingScriptLink в окне Обозреватель решений и последовательно выберите пункты Добавить и Новый элемент.

  5. В диалоговом окне Добавление нового элемента выберите шаблон Пустой элемент. Введите ReplaceARibbonButtonUsingScriptLink в качестве имени.

Задание настраиваемого действия

Для замены кнопки ленты используется атрибут Location элемента CommandUIDefinition. Значения по умолчанию для кнопок ленты перечислены в статье Размещение настроек ленты сервера по умолчанию. Более подробное описание XML-кода ленты см. в статье XML-код ленты сервера.

Задание настраиваемого действия

  1. Откройте файл Elements.xml.

  2. Вставьте приведенный ниже XML-код в файл Elements.xml. Этот XML-код заменяет собой кнопку Подключиться к Outlook на вкладке Библиотека в группе Подключение и экспорт для библиотеки документов.

    Важное примечаниеВажно!

    Замените атрибуты Image32by32 и Image16by16 действительными URL-адресами изображений.

    <?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>
    

Развертывание настройки

Поскольку проект был настроен как фермы, он автоматически развертывается, и производится перезапуск служб IIS.

Развертывание настройки

  1. Нажмите клавишу F5. разработки SharePoint в Visual Studio 2010 автоматически выполнит построение и развертывание компонента.

  2. Перейдите в библиотеку документов на своем сайте или дочернем сайте.

  3. Перейдите на вкладку Библиотека и убедитесь, что в группе Подключение и экспорт кнопка Подключиться к Outlook отсутствует.

См. также

Концепции

XML-код ленты сервера

Декларативная настройка ленты сервера

EcmaScript и лента сервера

Принудительная настройка ленты сервера