Поделиться через

Пошаговое руководство. Создание элемента проекта настраиваемого действия с помощью шаблона элемента, часть 1

  • Статья

Можно расширить систему проектов SharePoint в Visual Studio путем создания собственных типов элементов проектов.В данном пошаговом руководстве будет создан элемент проекта, который можно добавить в проект SharePoint для создания настраиваемого действия на сайте SharePoint.Это настраиваемое действие добавляет пункт к меню Действия сайта на сайте SharePoint.

В этом пошаговом руководстве показано выполнение следующих задач.

  • Создание расширения Visual Studio, в котором определяется новый тип элемента проекта SharePoint для настраиваемого действия.В новом типе элемента проекта реализовано несколько настраиваемых возможностей:

    • контекстное меню для запуска дополнительных задач, связанных с элементом проекта, например для отображения конструктора настраиваемых действий в Visual Studio;

    • код, выполняемый при изменении разработчиком определенных свойств элемента проекта, содержащегося в проекте;

    • настраиваемый значок, отображаемый рядом с элементом проекта в обозревателе решений.

  • Создание шаблона элемента Visual Studio для данного элемента проекта.

  • Построение пакета расширения Visual Studio (VSIX) для развертывания шаблона элемента проекта и сборки расширения.

  • Отладка и тестирование элемента проекта.

Это пошаговое руководство является отдельным.По завершении данного пошагового руководства вы сможете усовершенствовать элемент проекта, добавив мастер в его шаблон.Дополнительные сведения см. в разделе Пошаговое руководство. Создание элемента проекта настраиваемого действия с помощью шаблона элемента, часть 2.

ПримечаниеПримечание

Пример, содержащий готовые проекты, код и другие файлы для данного пошагового руководства, можно загрузить на следующей странице: https://go.microsoft.com/fwlink/?LinkId=191369.

Обязательные компоненты

Для выполнения данного пошагового руководства на компьютере разработчика должны быть установлены следующие компоненты:

Знание следующих подходов может оказаться полезным, но не требуется для выполнения пошагового руководства.

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

Чтобы выполнить это пошаговое руководство, необходимо создать три проекта:

  • Проект VSIX.Проект создает пакет VSIX для развертывания элемента проекта SharePoint.

  • Проект шаблона элемента.Этот проект создает шаблон элемента, который может быть использован для добавления элемента проекта SharePoint в проект SharePoint.

  • Проект библиотеки классов.Проект реализует расширение Visual Studio, определяющее поведение элемента проекта SharePoint.

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

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

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

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

  3. В списке в верхней части диалогового окна Создать проект, убедитесь, что платформа .NET Framework 4,5 выделен.

  4. В диалоговом окне Создать проект разверните узлы Visual C# или Visual Basic, а затем выберите узел Расширение среды.

    ПримечаниеПримечание

    Узел Расширение среды доступен, только если установить пакет SDK для Visual Studio.Дополнительные сведения см. в параграфе предварительных требований ранее в этом разделе.

  5. Выберите шаблон Проект VSIX.

  6. В окне Имя, вставки CustomActionProjectItem, а затем кнопку ОК.

    Visual Studio добавит в Обозреватель решений проект CustomActionProjectItem.

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

  1. В Обозреватель решений открыть контекстное меню для узла решения выберите Добавить, а затем выберите Создать проект.

    ПримечаниеПримечание

    В проектах Visual Basic узел решения отображается в обозревателе решений, только если в диалоговом окне General, Projects and Solutions, Options Dialog Box установлен флажок Всегда показывать решение.

  2. В списке в верхней части диалогового окна Создать проект, убедитесь, что платформа .NET Framework 4,5 выделен.

  3. В диалоговом окне Создать проект разверните узлы Visual C# или Visual Basic, а затем выберите узел Расширение среды.

  4. В списке шаблонов проектов выберите шаблон шаблон элемента C# или Шаблон элемента Visual Basic.

  5. В окне Имя, вставки ItemTemplate, а затем кнопку ОК.

    Visual Studio добавит в решение проект ItemTemplate.

Создание проекта расширения

  1. В Обозреватель решений открыть контекстное меню для узла решения выберите Добавить, а затем выберите Создать проект.

  2. В списке в верхней части диалогового окна Создать проект, убедитесь, что платформа .NET Framework 4,5 выделен.

  3. В диалоговом окне Создать проект разверните узлы Visual C# или Visual Basic выберите узел Окна, а затем выберите шаблон проекта Библиотека классов.

  4. В окне Имя, вставки ProjectItemDefinition, а затем кнопку ОК.

    Visual Studio добавляет проект ProjectItemDefinition в решение и открывает заданный по умолчанию файл с кодом Class1.

  5. Удалите из проекта файл c кодом Class1.

Настройка проекта расширения

Перед написанием кода, определяющего тип элемента проекта SharePoint, необходимо добавить в проект расширения ссылки на сборки и файлы с кодом.

Настройка проекта

  1. В Обозреватель решений открыть контекстное меню для проекта ProjectItemDefinition выберите Добавить, а затем выберите Создать элемент.

  2. В списке элементов проекта выберите Файл с текстом программы.

  3. В окне Имя введите имя CustomAction с соответствующим расширением имени файла, а затем нажмите кнопку Добавить.

  4. В Обозреватель решений открыть контекстное меню для проекта ProjectItemDefinition, а затем выберите Добавить ссылку.

  5. В диалоговом окне Диспетчер ссылок – ProjectItemDefinition выберите узел Сборки, а затем выберите узел Платформа.

  6. Установите флажок рядом с каждой из следующих сборок:

    • System.ComponentModel.Composition

    • System.Windows.Forms

  7. Выберите узел Расширения установите флажок рядом с сборку Microsoft.VisualStudio.Sharepoint, а затем нажмите кнопку ОК.

Определение нового типа элемента проекта SharePoint

Создайте класс, реализующий интерфейс ISharePointProjectItemTypeProvider, чтобы определить поведение нового типа элемента проекта.Этот интерфейс следует реализовывать всякий раз, когда требуется определить новый тип элемента проекта.

Определение нового типа элемента проекта SharePoint

  1. В проекте ProjectItemDefinition откройте файл с кодом CustomAction.

  2. Замените код в этом файле следующим кодом.

    Imports System
Imports System.Diagnostics
Imports System.ComponentModel
Imports System.ComponentModel.Composition
Imports Microsoft.VisualStudio.SharePoint

Namespace Contoso.SharePointProjectItems.CustomAction

    ' Export attribute: Enables Visual Studio to discover and load this extension.
    ' SharePointProjectItemType attribute: Specifies the ID for this new project item type. This string must 
    '     match the value of the Type attribute of the ProjectItem element in the .spdata file for 
    '     the project item.
    ' SharePointProjectItemIcon attribute: Specifies the icon to display with this project item in Solution Explorer.
    ' CustomActionProjectItemTypeProvider class: Defines a new type of project item that can be used to create a custom 
    '     action on a SharePoint site.
    <Export(GetType(ISharePointProjectItemTypeProvider))> _
    <SharePointProjectItemType("Contoso.CustomAction")> _
    <SharePointProjectItemIcon("ProjectItemDefinition.CustomAction_SolutionExplorer.ico")> _
    Partial Friend Class CustomActionProjectItemTypeProvider
        Implements ISharePointProjectItemTypeProvider

        Private WithEvents projectItemTypeDefinition As ISharePointProjectItemTypeDefinition

        ' Configures the behavior of the project item type.
        Private Sub InitializeType(ByVal projectItemTypeDefinition As ISharePointProjectItemTypeDefinition) _
            Implements ISharePointProjectItemTypeProvider.InitializeType

            projectItemTypeDefinition.Name = "CustomAction"
            projectItemTypeDefinition.SupportedDeploymentScopes = _
                SupportedDeploymentScopes.Site Or SupportedDeploymentScopes.Web
            projectItemTypeDefinition.SupportedTrustLevels = SupportedTrustLevels.All
            Me.projectItemTypeDefinition = projectItemTypeDefinition
        End Sub

        Private Const DesignerMenuItemText As String = "View Custom Action Designer"

        Private Sub ProjectItemMenuItemsRequested(ByVal Sender As Object, _
            ByVal e As SharePointProjectItemMenuItemsRequestedEventArgs) _
            Handles projectItemTypeDefinition.ProjectItemMenuItemsRequested

            Dim viewDesignerMenuItem As IMenuItem = e.ViewMenuItems.Add(DesignerMenuItemText)
            AddHandler viewDesignerMenuItem.Click, AddressOf MenuItemClick
        End Sub

        Private Sub MenuItemClick(ByVal Sender As Object, ByVal e As MenuItemEventArgs)
            Dim projectItem As ISharePointProjectItem = CType(e.Owner, ISharePointProjectItem)
            Dim message As String = String.Format("You clicked the menu on the {0} item. " & _
                "You could perform some related task here, such as displaying a designer " & _
                "for the custom action.", projectItem.Name)
            System.Windows.Forms.MessageBox.Show(message, "Contoso Custom Action")
        End Sub

        Private Sub ProjectItemNameChanged(ByVal Sender As Object, ByVal e As NameChangedEventArgs) _
            Handles projectItemTypeDefinition.ProjectItemNameChanged
            Dim projectItem As ISharePointProjectItem = CType(Sender, ISharePointProjectItem)
            Dim message As String = String.Format("The name of the {0} item changed to: {1}", _
                e.OldName, projectItem.Name)
            projectItem.Project.ProjectService.Logger.WriteLine(message, LogCategory.Message)
        End Sub
    End Class
End Namespace

    using System;
using System.Diagnostics;
using System.ComponentModel;
using System.ComponentModel.Composition;
using Microsoft.VisualStudio.SharePoint;

namespace Contoso.SharePointProjectItems.CustomAction
{
    // Enables Visual Studio to discover and load this extension.
    [Export(typeof(ISharePointProjectItemTypeProvider))]

    // Specifies the ID for this new project item type. This string must match the value of the 
    // Type attribute of the ProjectItem element in the .spdata file for the project item.
    [SharePointProjectItemType("Contoso.CustomAction")]

    // Specifies the icon to display with this project item in Solution Explorer.
    [SharePointProjectItemIcon("ProjectItemDefinition.CustomAction_SolutionExplorer.ico")]

    // Defines a new type of project item that can be used to create a custom action on a SharePoint site.
    internal partial class CustomActionProjectItemTypeProvider : ISharePointProjectItemTypeProvider
    {
        // Implements IProjectItemTypeProvider.InitializeType. Configures the behavior of the project item type.
        public void InitializeType(ISharePointProjectItemTypeDefinition projectItemTypeDefinition)
        {
            projectItemTypeDefinition.Name = "CustomAction";
            projectItemTypeDefinition.SupportedDeploymentScopes =
                SupportedDeploymentScopes.Site | SupportedDeploymentScopes.Web;
            projectItemTypeDefinition.SupportedTrustLevels = SupportedTrustLevels.All;

            projectItemTypeDefinition.ProjectItemNameChanged += ProjectItemNameChanged;
            projectItemTypeDefinition.ProjectItemMenuItemsRequested += ProjectItemMenuItemsRequested;
        }

        private const string designerMenuItemText = "View Custom Action Designer";

        private void ProjectItemMenuItemsRequested(object sender, SharePointProjectItemMenuItemsRequestedEventArgs e)
        {
            e.ViewMenuItems.Add(designerMenuItemText).Click += MenuItemClick;
        }

        private void MenuItemClick(object sender, MenuItemEventArgs e)
        {
            ISharePointProjectItem projectItem = (ISharePointProjectItem)e.Owner;
            string message = String.Format("You clicked the menu on the {0} item. " +
                "You could perform some related task here, such as displaying a designer " +
                "for the custom action.", projectItem.Name);
            System.Windows.Forms.MessageBox.Show(message, "Contoso Custom Action");
        }

        private void ProjectItemNameChanged(object sender, NameChangedEventArgs e)
        {
            ISharePointProjectItem projectItem = (ISharePointProjectItem)sender;
            string message = String.Format("The name of the {0} item changed to: {1}",
                e.OldName, projectItem.Name);
            projectItem.Project.ProjectService.Logger.WriteLine(message, LogCategory.Message);
        }
    }
}

Создание значка для элемента проекта в обозревателе решений

При создании пользовательского элемента проекта SharePoint с этим элементом проекта можно связать изображение (значок или растровое изображение).Это изображение отображается рядом с элементом проекта в обозревателе решений.

В следующей процедуре создается значок для элемента проекта; кроме того, этот значок внедряется в сборку расширения.Ссылка на эту сборку указывается в атрибуте SharePointProjectItemIconAttribute созданного перед этим класса CustomActionProjectItemTypeProvider.

Создание пользовательского значка для элемента проекта

  1. В Обозреватель решений открыть контекстное меню для проекта ProjectItemDefinition выберите Добавить, а затем выберите Новый элемент…..

  2. В списке элементов проекта выберите элемент Файл значка.

    ПримечаниеПримечание

    В проектах Visual Basic, необходимо выбрать узел Общие для отображения элемента Файл значка.

  3. В окне Имя, вставки CustomAction_SolutionExplorer.ico, а затем кнопку Добавить.

    Новый значок будет отрыт в Редакторе изображений.

  4. Измените версию файла значка размером 16x16, чтобы его можно было отличить от других значков, и сохраните файл значка.

  5. В Обозреватель решений выберите CustomAction_SolutionExplorer.ico.

  6. В окне Свойства выберите стрелку, расположенную рядом с свойством Действие при построении.

  7. В списке который отображается, выберите Внедренный ресурс.

Контрольная точка

Теперь проект содержит весь код, необходимый для реализации элемента проекта, который рассматривается в данном пошаговом руководстве.Постройте проект, чтобы проверить, что он будет компилироваться без ошибок.

Построение проекта

  • Открыть контекстное меню для проекта ProjectItemDefinition и выберите Построение.

Создание шаблона элемента Visual Studio

Чтобы другие разработчики также могли использовать новый элемент проекта, необходимо создать шаблон проекта или шаблон элемента проекта.Разработчики используют в Visual Studio шаблоны для создания экземпляра элемента проекта путем создания нового проекта или путем добавления элемента в имеющийся проект.Для этого пошагового руководства воспользуйтесь проектом ItemTemplate для настройки элемента проекта.

Создание шаблона элемента

  1. Удалите из проекта ItemTemplate файл с кодом Class1.

  2. Откройте файл ItemTemplate.vstemplate в проекте ItemTemplate.

  3. Замените содержимое файла следующим XML-кодом, затем сохраните и закройте файл.

    ПримечаниеПримечание

    Следующий XML-код предназначен для шаблона элемента на языке Visual C#.Если шаблон элемента создается на языке Visual Basic, замените значение элемента ProjectType на VisualBasic.

    		 
    <?xml version="1.0" encoding="utf-8"?>
<VSTemplate Version="2.0.0" xmlns="https://schemas.microsoft.com/developer/vstemplate/2005" Type="Item">
  <TemplateData>
    <DefaultName>CustomAction</DefaultName>
    <Name>Custom Action</Name>
    <Description>SharePoint Custom Action by Contoso</Description>
    <ProjectType>CSharp</ProjectType>
    <SortOrder>1000</SortOrder>
    <Icon>ItemTemplate.ico</Icon>
    <ProvideDefaultName>true</ProvideDefaultName>
  </TemplateData>
  <TemplateContent>
    <ProjectItem ReplaceParameters="true" TargetFileName="$fileinputname$\Elements.xml">Elements.xml</ProjectItem>
    <ProjectItem ReplaceParameters="true" TargetFileName="$fileinputname$\SharePointProjectItem.spdata">CustomAction.spdata</ProjectItem>
  </TemplateContent>
</VSTemplate>

    Этот файл определяет содержимое и поведение шаблона элемента.Дополнительные сведения о содержимом этого файла см. в разделе Справочник по схеме шаблонов Visual Studio.

  4. В Обозреватель решений открыть контекстное меню для проекта ItemTemplate выберите Добавить, а затем выберите Создать элемент.

  5. В диалоговом окне Добавление нового элемента выберите шаблон Текстовый файл.

  6. В окне Имя, вставки CustomAction.spdata, а затем кнопку Добавить.

  7. Добавьте в файл CustomAction.spdata следующий XML-код, а затем сохраните и закройте файл.

    <?xml version="1.0" encoding="utf-8"?>
<ProjectItem Type="Contoso.CustomAction" DefaultFile="Elements.xml" 
 xmlns="https://schemas.microsoft.com/VisualStudio/2010/SharePointTools/SharePointProjectItemModel">
  <Files>
    <ProjectItemFile Source="Elements.xml" Target="$fileinputname$\" Type="ElementManifest" />
  </Files>
</ProjectItem>

    Этот файл содержит сведения о файлах, входящих в другие элементы проекта.Атрибут Type элемента ProjectItem должен равняться строке, переданной атрибуту SharePointProjectItemTypeAttribute определения элемента проекта (см. ранее созданный в этом пошаговом руководстве класс CustomActionProjectItemTypeProvider).Дополнительные сведения о содержимом SPDATA-файлов см. в разделе Справочные материалы по схеме элементов проектов SharePoint.

  8. В Обозреватель решений открыть контекстное меню для проекта ItemTemplate выберите Добавить, а затем выберите Создать элемент.

  9. В диалоговом окне Добавление нового элемента выберите шаблон XML-файл.

  10. В окне Имя, вставки Elements.xml, а затем кнопку Добавить.

  11. Замените содержимое файла Elements.xml следующим XML-кодом, затем сохраните и закройте файл.

    <?xml version="1.0" encoding="utf-8" ?>
<Elements Id="$guid8$" xmlns="https://schemas.microsoft.com/sharepoint/">
  <CustomAction Id="Replace this with a GUID or some other unique string"
                GroupId="SiteActions"
                Location="Microsoft.SharePoint.StandardMenu"
                Sequence="1000"
                Title="Replace this with your title"
                Description="Replace this with your description" >
    <UrlAction Url="~site/Lists/Tasks/AllItems.aspx"/>
  </CustomAction>
</Elements>

    Этот файл определяет настраиваемое действие по умолчанию и создает пункт в меню Действия сайта для сайта SharePoint.Когда пользователь выбирает пункт меню, URL-адрес из поля открытых элементов UrlAction в обозревателе Интернета.Дополнительные сведения о XML-элементах, которые можно использовать для определения пользовательского действия, см. в разделе Custom Action Definitions.

  12. Дополнительно можно открыть файл ItemTemplate.ico и изменить его для лучшего узнавания.Значок будет отображаться рядом с элементом проекта в диалоговом окне Добавление нового элемента.

  13. В Обозреватель решений открыть контекстное меню для проекта ItemTemplate, а затем выберите Выгрузить проект.

  14. Раскрывайте контекстное меню для проекта ItemTemplate, а затем выберите правка ItemTemplate.csproj или правка ItemTemplate.vbproj.

  15. Найдите следующий элемент VSTemplate в файле проекта.

    <VSTemplate Include="ItemTemplate.vstemplate">

  16. Замените этот элемент VSTemplate следующим XML-кодом, а затем сохраните и закройте файл.

    <VSTemplate Include="ItemTemplate.vstemplate">
  <OutputSubPath>SharePoint\SharePoint14</OutputSubPath>
</VSTemplate>

    Элемент OutputSubPath задает путь к дополнительным папкам, в которых при построении проекта создается шаблон элемента.Заданные здесь папки обеспечивают что шаблон элемента будет доступен, только если клиенты раскроют диалоговое окно Добавление нового элемента разверните узел SharePoint, а затем выберите узел 2010.

  17. В Обозреватель решений открыть контекстное меню для проекта ItemTemplate, а затем выберите Перезагрузить проект.

Создание пакета VSIX для развертывания элемента проекта

Для развертывания расширения воспользуйтесь проектом VSIX в своем решении для создания пакета VSIX.Сначала настройте пакет VSIX, изменив содержимое файла source.extension.vsixmanifest, входящего в состав проекта VSIX.Затем создайте пакет VSIX, выполнив построение решения.

Настройка и создание пакета VSIX

  1. В Обозреватель решений открыть контекстное меню для файла source.extension.vsixmanifest в проект CustomActionProjectItem, а затем выберите Открыть.

    Файл будет открыт Visual Studio в редакторе манифестов.Файл source.extension.vsixmanifest качестве основы для файла extension.vsixmanifest которого все пакеты VSIX.Дополнительные сведения об этом файле см. в разделе Справочник по схеме расширения VSIX.

  2. В окне Название продукта введите элемент проекта настраиваемого действия.

  3. В окне Автор введите Contoso.

  4. В окне Описание введите Элемент проекта SharePoint, представляющий настраиваемое действие.

  5. На вкладке Активы, нажмите кнопку Создать.

    Диалоговое окно Добавить новый актив.

  6. В списке Тип выберите Microsoft.VisualStudio.ItemTemplate.

    ПримечаниеПримечание

    Это значение соответствует элементу ItemTemplate, описанному в файле extension.vsixmanifest.Этот элемент определяет вложенную папку в пакете VSIX, содержащую шаблон элемента проекта.Дополнительные сведения см. в разделе ItemTemplate Element.

  7. В списке Источник выберите Проект в текущем решении.

  8. В списке Проект выберите ItemTemplate, а затем нажмите кнопку ОК.

  9. На вкладке Активы, нажмите кнопку Создать попытку.

    Диалоговое окно Добавить новый актив.

  10. В списке Тип выберите Microsoft.VisualStudio.MefComponent.

    ПримечаниеПримечание

    Это значение соответствует элементу MefComponent, описанному в файле extension.vsixmanifest.Этот элемент задает имя сборки расширения в пакете VSIX.Дополнительные сведения см. в разделе MEFComponent Element.

  11. В списке Источник выберите Проект в текущем решении.

  12. В списке Проект выберите ProjectItemDefinition.

  13. Нажмите кнопку ОК.

  14. В строке меню выберите Построение, Построить решение и убедитесь, что проект будет компилироваться без ошибок.

  15. Убедитесь, что в выходную папку построения для проекта CustomActionProjectItem содержит файл CustomActionProjectItem.vsix.

    По умолчанию выходной папкой построения является папка ..Папка \bin\Debug, расположенная в папке, содержащей проект CustomActionProjectItem.

Тестирование элемента проекта

Элемент проекта готов к тестированию.Начните отладку решения CustomActionProjectItem в экспериментальном экземпляре Visual Studio.Затем протестируйте элемент проекта Настраиваемое действие проекта SharePoint в экспериментальном экземпляре Visual Studio.И наконец, выполните построение и запустите проект SharePoint, чтобы проверить, что настраиваемое действие работает ожидаемым образом.

Начало отладки решения

  1. Перезапустите Visual Studio с учетными данными администратора, а затем открыть решения CustomActionProjectItem.

  2. Откройте файл кода CustomAction, а затем добавьте точку останова на первой строке кода в методе InitializeType.

  3. Выберите ключ F5, чтобы начать отладку.

    Visual Studio установит расширение в папку %UserProfile%\AppData\Local\Microsoft\VisualStudio\10.0Exp\Extensions\Contoso\Custom Action Project Item\1.0 и запустит экспериментальный экземпляр Visual Studio.Тестировании элемент проекта в данном экземпляре Visual Studio.

Тестирование элемента проекта в Visual Studio

  1. В экспериментальном экземпляре Visual Studio в строке меню выберите Файл, Создать, Проект.

  2. Разверните Visual C# или Visual Basic (в зависимости от языка, который поддерживает шаблон элемента), SharePoint, а затем выберите узел 2010.

  3. В списке шаблонов проектов выберите Проект SharePoint 2010.

  4. В окне Имя, вставки CustomActionTest, а затем кнопку ОК.

  5. В Мастер настройки SharePoint введите URL-адрес сайта, который необходимо использовать для отладки, а затем нажмите кнопку Готово.

  6. В Обозреватель решений открыть контекстное меню для узла проекта выберите Добавить, а затем выберите Создать элемент.

  7. В диалоговом окне Добавление нового элемента выберите узел 2010 в узле SharePoint.

    Убедитесь, что элемент Настраиваемое действие отображается в списке элементов проекта.

  8. Выберите элемент Настраиваемое действие, а затем нажмите кнопку Добавить.

    Visual Studio добавляет элемент с именем CustomAction1 в проект и открывается файл Elements.xml в редакторе.

  9. Убедитесь, что выполнение кода в другом экземпляре Visual Studio прерывается на точке останова, заданной ранее в методе InitializeType.

  10. Выберите ключ F5, чтобы продолжить отладку проекта.

  11. В экспериментальном экземпляре Visual Studio в Обозреватель решений открыть контекстное меню для узла CustomAction1, а затем выберите Конструктор просмотр настраиваемого действия.

  12. Проверьте, что появляется окно сообщения, а затем нажмите кнопку ОК.

    С помощью этого контекстного меню можно реализовать дополнительные параметры и команды для разработчиков, например отображение конструктора для настраиваемого действия.

  13. В строке меню выберите Вид, Вывод.

    Откроется окно Выходные данные.

  14. В Обозреватель решений открыть контекстное меню для элемента CustomAction1, а затем измените ее имя на MyCustomAction.

    В окне Вывод, подтверждение.Это сообщение записывано обработчиком событий ProjectItemNameChanged, определенный в классе CustomActionProjectItemTypeProvider.С помощью обработчиков для этого и других событий элемента проекта можно реализовать настраиваемое поведение, которое может изменять разработчик, настраивая элемент проекта.

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

  1. В экспериментальном экземпляре Visual Studio, откройте файл Elements.xml, который является дочерним элементом элемента проекта MyCustomAction.

  2. В файле Elements.xml, внесите следующие изменения, а затем сохраните файл.

    • В элементе CustomAction, задайте для атрибута Id на идентификатор GUID или какой-либо другой уникальный строке, как показано в следующем примере:

      Id="cd85f6a7-af2e-44ab-885a-0c795b52121a"

    • В элементе CustomAction, задайте для атрибута Title как показано в следующем примере:

      Title="SharePoint Developer Center"

    • В элементе CustomAction, задайте для атрибута Description как показано в следующем примере:

      Description="Opens the SharePoint Developer Center Web site."

    • В элементе UrlAction, задайте для атрибута URL как показано в следующем примере:

      Url="https://msdn.microsoft.com/sharepoint/default.aspx"

  3. Выберите ключ F5.

    Пользовательское действие было представлено отдельным пакетом, пригодным к сайту SharePoint и развертыватьо, указанным в свойстве URL-адрес сайта проекта.В Интернет-браузере открывает страницу по умолчанию данного сайта.

    ПримечаниеПримечание

    Если откроется диалоговое окно Отладка скриптов отключена отображается, нажмите кнопку Да, чтобы продолжить отладку проекта.

  4. В меню Поместите действия выберите Центр разработчика SharePoint, убедитесь, что браузер открывает веб-сайт https://msdn.microsoft.com/sharepoint/default.aspx, а затем закройте Интернет-браузер.

Очистка компьютера разработчика

После завершения тестирования элемента проекта удалите шаблон элемента проекта из экспериментального экземпляра Visual Studio.

Очистка компьютера разработчика

  1. В экспериментальном экземпляре Visual Studio в строке меню выберите Сервис, Расширения и обновления.

    Будет открыто диалоговое окно Расширения и обновления.

  2. В списке расширений выберите элемент проекта настраиваемого действия, а затем нажмите кнопку Удалить.

  3. В появившемся диалоговом окне нажмите кнопку Да, чтобы подтвердить удаление расширения.

  4. Нажмите кнопку Перезагрузить сейчас для завершения удаления.

  5. Закройте и экспериментальном экземпляре Visual Studio и экземпляр, в котором решения CustomActionProjectItem открыто.

Следующие действия

По завершении данного пошагового руководства вы можете добавить мастер к шаблону элемента.Когда пользователь добавляет элемент проекта настраиваемого действия в проект SharePoint мастер собирает сведения о действии (например, его расположение и URL-адрес для перехода при действие выбрана), и добавляет эти данные в файл Elements.xml нового элемента проекта.Дополнительные сведения см. в разделе Пошаговое руководство. Создание элемента проекта настраиваемого действия с помощью шаблона элемента, часть 2.

См. также

Задачи

Пошаговое руководство. Создание элемента проекта настраиваемого действия с помощью шаблона элемента, часть 2

Создание значка или другого изображения (редактор изображений для значков)

Ссылки

Справочник по схеме шаблонов Visual Studio

Редактор изображений для значков

Основные понятия

Определение пользовательских типов элементов проектов SharePoint

Создание шаблонов элементов и проектов для элементов проектов SharePoint

Использование службы проектов SharePoint