Sdílet prostřednictvím

Podrobné pokyny: Vytvoření položky projektu vlastní akce položku šablony, část 1

  • Článek

Můžete rozšířit systém projektu služby SharePoint v Visual Studio 2010 vytvořením vlastního typu položky projektu. V tomto návodu vytvoříte položku projektu, která může být přidána do projektu SharePoint pro vytvoření vlastní akce na webu služby SharePoint. Vlastní akce přidá položku nabídky Akce serveru webu služby SharePoint.

Tento návod demonstruje následující úkoly:

  • Vytvoření rozšíření Visual Studio, která definuje nový typ položky projektu SharePoint pro vlastní akce. Nový typ položky projektu implementuje vlastní několik funkcí:

    • Nabídka zástupců slouží jako výchozí bod pro další úkoly spojené s položkou projekt, jako je například zobrazení návrháře pro vlastní akci v aplikaci Visual Studio.

    • Kód, který bude spuštěn, když vývojář změní určité vlastnosti položky projektu a projekt, který jej obsahuje.

    • Vlastní ikonu, která se zobrazí vedle položky projektu v Aplikaci Solution Explorer.

  • Vytváření šablony položky Visual Studio pro položku projektu.

  • Vytváření rozšíření aplikace Visual Studio balíčku (VSIX) pro nasazení šablony položky projektu a sestavení rozšíření.

  • Ladění a testování položky projektu.

Toto je samostatný postup. Po dokončení tohoto postupu můžete vylepšit přidáním průvodce šablonu položky položky projektu. Další informace naleznete v tématu Podrobné pokyny: Vytvoření položky projektu vlastní akce položku šablony, část 2.

Poznámka

Stáhnout vzorek, který obsahuje dokončených projektů, kód a jiné soubory tohoto postupu z následujícího umístění: https://go.microsoft.com/fwlink/?LinkId=191369.

Požadavky

Ve vývojovém počítači potřebujete následující součásti pro dokončení tohoto návodu:

Znalost následujících konceptů je užitečná, ale není požadována k dokončení návodu:

Vytváření projektů

Chcete-li dokončit tento návod, je nutné vytvořit tři projekty:

  • Projekt VSIX. Tento projekt vytvoří balíček VSIX k nasazení položky projektu služby SharePoint.

  • Projekt šablony položky. Tento projekt vytvoří šablonu položky, která může sloužit k přidání položky projektu služby SharePoint do projektu SharePoint.

  • Projekt knihovny tříd. Tento projekt implementuje rozšíření aplikace Visual Studio, které definuje chování položky projektu služby SharePoint.

Začněte postup vytvořením projektů.

Pro vytvoření projektu VSIX

  1. Spusťte nástroj Visual Studio.

  2. V nabídce File (Soubor) přejděte na příkaz New (Nový) a klepněte na příkaz Project (Projekt).

  3. V poli se seznamem v horní části dialogového okna Nový Projekt zkontrolujte, zda je vybráno .NET Framework 4.

  4. V dialogovém okně Nový projekt rozbalte uzly Visual C# nebo Visual Basic a potom klikněte na uzel Rozšiřitelnost.

    Poznámka

    Uzel Rozšiřitelnost je k dispozici pouze v případě, že nainstalujete Visual Studio 2010 SDK. Další informace naleznete ve výše uvedeném oddílu požadavků.

  5. Klikněte na šablonu Projekt VSIX.

  6. V poli Název zadejte CustomActionProjectItem.

  7. Klepněte na tlačítko OK.

    Visual Studio přidá projekt CustomActionProjectItem do Průzkumníku řešení.

Chcete-li vytvořit šablonu položky projektu

  1. V Průzkumníku řešení klikněte pravým tlačítkem myši na uzel řešení, klikněte na Přidat a pak na Nový projekt.

    Poznámka

    V projektech v jazyce Visual Basic se uzel řešení zobrazí v Průzkumníku řešení pouze pokud je označeno zaškrtávací políčko Vždy zobrazit řešení Obecné, projekty a řešení, dialogové okno Možnosti.

  2. V poli se seznamem v horní části dialogového okna Nový Projekt zkontrolujte, zda je vybráno .NET Framework 4.

  3. V dialogovém okně Nový projekt rozbalte uzly Visual C# nebo Visual Basic a potom klikněte na uzel Rozšiřitelnost.

  4. Vyberte v seznamu šablon projektů Šablonu položky C# nebo Položku šablony Visual Basic.

  5. Do pole Název zadejte ItemTemplate.

  6. Klikněte na tlačítko OK.

    Visual Studio přidá ItemTemplate projekt do řešení.

Chcete-li vytvořit projekt rozšíření

  1. V Průzkumníku řešení klikněte pravým tlačítkem myši na uzel řešení, klikněte na Přidat a pak na Nový projekt.

  2. V poli se seznamem v horní části dialogového okna Nový Projekt zkontrolujte, zda je vybráno .NET Framework 4.

  3. V dialogovém okně Nový projekt rozbalte uzel Visual C# nebo Visual Basic a potom klikněte na uzel Windows.

  4. Zvolte šablonu projektu Knihovna tříd.

  5. V poli Název zadejte ProjectItemDefinition.

  6. Klepněte na tlačítko OK.

    Visual Studio přidá projekt ProjectItemDefinition do řešení a otevře soubor výchozího kódu Class1.

  7. Odstraňte soubor kódu Class1 z projektu.

Konfigurace projektu rozšíření

Píšete kód definuje typ položky projektu SharePoint, musíte přidat kód soubory a odkazy na sestavení rozšíření projektu.

Chcete-li konfigurovat projekt

  1. V ProjectItemDefinition projektu přidáte kód soubory s názvem CustomAction.

  2. V nabídce Projekt klepněte na příkaz Přidat odkaz.

  3. Na záložce .NET stiskněte klávesu CTRL klikněte na tlačítko následujících sestavení a potom klikněte na tlačítko OK:

    • Microsoft.VisualStudio.SharePoint

    • System.ComponentModel.Composition

    • System.Windows.Forms

Definování nový typ položky projektu SharePoint

Vytvořit třídu, která implementuje ISharePointProjectItemTypeProvider rozhraní definují chování typ nové položky projektu. Implementujte toto rozhraní pokaždé, když chcete definovat nový typ položky projektu.

Definovat nový typ položky projektu SharePoint

  1. V projektu ProjectItemDefinition otevřete soubor kódu CustomAction.

  2. Nahraďte kód v tomto souboru následujícím kódem.

    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);
        }
    }
}

Vytváření ikony pro položku projektu v Průzkumníku řešení

Když vytvoříte vlastní položku projektu SharePoint, můžete přidružit obrázek (ikonu nebo bitmapu) s položkou projektu. Tento obrázek se zobrazuje vedle položky projektu v Průzkumníku řešení.

V následující proceduře vytvoříte ikonu pro položku projektu a vložíte ikonu do sestavení rozšíření. Tato ikona odkazovaná SharePointProjectItemIconAttribute třídy CustomActionProjectItemTypeProvider, kterou jste vytvořili dříve.

Chcete-li vytvořit vlastní ikonu položky projektu

  1. V Průzkumníku řešení klikněte prým tlačítkem myši na projekt ProjectItemDefinition

  2. V místní nabídce klikněte na Přidat a poté klikněte na Novou položku.

  3. V seznamu položek projektu klikněte na Soubor ikony.

    Poznámka

    V projektech Visual Basic musíte kliknout na uzel Obecné pro zobrazení položky Soubor ikony.

  4. Napište CustomAction_SolutionExplorer.ico pro novou ikonu, zadejte název a klikněte na tlačítko Přidat.

    Nová ikona se otevře v Editoru obrázků.

  5. Upravte 16x16 verzi souboru ikony tak, aby měla vyhovující vzor a potom uložte soubor ikony.

  6. V Průzkumníku řešení klikněte na CustomAction_SolutionExplorer.ico.

  7. V okně Vlastnosti klikněte na tlačítko rozevíracího seznamu vedle Sestavení akce a potom klikněte na Vestavěný prostředek.

Checkpoint

V tomto okamžiku návodu je celý kód pro položku projektu v projektu. Sestavte projekt, abyste se ujistili, že se zkompiluje bez chyb.

Chcete-li sestavit projekt

  • V nabídce Sestavit zvolte Sestavit řešení.

Vytváření šablony položky Visual Studio

Chcete-li povolit ostatním vývojářům použít vaše položky projektu, musíte vytvořit šablonu projektu nebo šablonu položky projektu. Vývojáři používají tyto šablony v aplikaci Visual Studio pro vytvoření instance položky projektu, vytvoření nového projektu nebo přidání položky do existujícího projektu. Pro tento návod použijte projekt ItemTemplate ke konfiguraci položky projektu.

Chcete-li vytvořit šablonu položky

  1. Odstraňte soubor Class1 kódu z projektu Položka ItemTemplate.

  2. V projektu ItemTemplate otevřete soubor ItemTemplate.vstemplate.

  3. Nahraďte obsah souboru následujícím XML a potom uložte a zavřete soubor.

    Poznámka

    Následující kód XML je pro šablonu položky Visual C#. Pokud vytváříte šablonu položky Visual Basic, nahraďte hodnotu prvku ProjectType s VisualBasic.

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

    Tento soubor definuje obsah a chování šablony položky. Další informace o obsahu tohoto souboru naleznete v tématu Visual Studio šablona schéma Odkaz….

  4. V Průzkumníku řešení klikněte pravým tlačítkem myši na projekt ItemTemplate, klikněte na Přidat a pak klikněte na Nová položka.

  5. V dialogovém okně Přidat novou položku zvolte Textový soubor, napište CustomAction.spdata v poli Název a klikněte na tlačítko Přidat.

  6. Přidejte následující XML do souboru CustomAction.spdata a potom soubor uložte a zavřete.

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

    Tento soubor obsahuje informace o souborech, které jsou obsaženy v položce projektu. Atribut Type prvku ProjectItem musí být nastavena na stejný řetězec, který je předán SharePointProjectItemTypeAttribute na definici položky projektu (CustomActionProjectItemTypeProvider třídy vytvořené dříve v tomto návodu). Další informace o obsahu .spdata souborů naleznete v tématu Referenční schéma SharePoint položky.

  7. V Průzkumníku řešení klikněte pravým tlačítkem myši na projekt ItemTemplate, klikněte na Přidat a pak klikněte na Nová položka.

  8. V dialogovém okně Přidat novou položku zvolte XML soubor, napište Elements.xml do poli Název a klikněte na tlačítko Přidat.

  9. Nahraďte obsah souboru Elements.xml následujícím XML a potom uložte a zavřete soubor.

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

    Tento soubor definuje výchozí vlastní akci, kterou vytvoří položka nabídky v nabídce Akce serveru webu služby SharePoint. Když uživatel klikne na položku nabídky, adresa URL zadaná v prvku UrlAction se otevře ve webovém prohlížeči. Další informace o elementy XML můžete definovat vlastní akce naleznete Vlastní definice akce.

  10. V případě potřeby otevřete soubor ItemTemplate.ico a změňte ho tak, aby vám design vyhovoval. Tato ikona se zobrazí vedle položky projektu v dialogovém okně Přidat novou položku.

  11. V Průzkumníku řešení klikněte pravým tlačítkem myši na projekt ItemTemplate a klikněte na Uvolnit projekt.

  12. Klikněte pravým tlačítkem myši na projekt ItemTemplate znovu a klikněte na tlačítko Úprava ItemTemplate.csproj nebo Úprava ItemTemplate.vbproj.

  13. Najděte následující prvek VSTemplate v souboru projektu.

    <VSTemplate Include="ItemTemplate.vstemplate">

  14. Nahraďte tento prvek VSTemplate s následujícím XML.

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

    Prvek OutputSubPath určuje další složky v cestě, pod kterými je šablona položky vytvořena při sestavení projektu. Zde určené složky zajistí, aby šablona položky byla k dispozici pouze, když zákazníci kliknou na uzel 2010 v rámci uzlu SharePoint v dialogovém okně Přidat novou položku.

  15. Soubor uložte a zavřete.

  16. V Průzkumníku řešení klikněte pravým tlačítkem myši na projekt ItemTemplate a klikněte na Znovu načíst projekt.

Vytvoření balíčku VSIX k nasazení položky projektu

Chcete-li nasadit rozšíření, použijte VSIX projekt ve vašem řešení k vytvoření VSIX balíčku. Nejprve nakonfigurujte VSIX balíček úpravou souboru source.extension.vsixmanifest, který je součástí projektu VSIX. Potom vytvořte VSIX balíček vytvořením řešení.

Chcete-li konfigurovat a vytvořit balíček VSIX

  1. V Průzkumníku řešení poklikejte na soubor source.extension.vsixmanifest v projektu CustomActionProjectItem.

    Visual Studio otevře soubor v editoru manifestu. Soubor source.extension.vsixmanifest je základem pro soubor extension.vsixmanifest, který je vyžadován pro všechny balíčky VSIX. Další informace o tomto souboru získáte v tématu VSX Schema for Extensions.

  2. V poli Název produktu zadejte Vlastní položka projektu akce.

  3. V poli Autor napište Contoso.

  4. V poli Popis zadejte Položka projektu služby SharePoint, která představuje vlastní akci.

  5. V oddílu Obsah editoru klikněte na tlačítko Přidání obsahu.

  6. V dialogovém okně Přidat obsah v seznamu Volba typu obsahu zvolte Šablona položky.

    Poznámka

    Tato hodnota odpovídá prvku ItemTemplate v souboru extension.vsixmanifest file. Tento prvek identifikuje podsložku v balíčku VSIX, který obsahuje šablonu položky projektu. Další informace naleznete v tématu ItemTemplate Element (VSX Schema).

  7. Pod Vybrat zdroj, klepněte projektu rádiové tlačítko a vyberte Položka ItemTemplate v seznamu vedle něj.

  8. Klepněte na tlačítko OK.

  9. V editoru manifestu znovu klikněte na tlačítko Přidání obsahu.

  10. V dialogovém okně Přidání obsahu v seznamu Volba typu obsahu zvolte Komponenta MEF.

    Poznámka

    Tato hodnota odpovídá prvku MefComponent v souboru extension.vsixmanifest file. Tento prvek určuje název sestavení rozšíření v balíčku VSIX. Další informace naleznete v tématu MEFComponent Element (VSX Schema).

  11. Pod Vybrat zdroj, klepněte projektu rádiové tlačítko a vyberte ProjectItemDefinition v seznamu vedle něj.

  12. Klepněte na tlačítko OK.

  13. V nabídce Build (Sestavit) klepněte na příkaz Build Solution (Sestavit řešení). Přesvědčte se, zda je projekt zkompilován bez chyb.

  14. Otevřete složku výstupu sestavení pro projekt CustomActionProjectItem. Ujistěte se, zda tato složka nyní obsahuje soubor CustomActionProjectItem.vsix.

    Ve výchozím nastavení je výstupní složka sestavení \bin\Debug složka pod složkou, která obsahuje projekt CustomActionProjectItem.

Testování položky projektu

Nyní jste připraveni k testování položky projektu. Nejprve spusťte ladění řešení CustomActionProjectItem v experimentální instanci aplikace Visual Studio. Potom testujte vlastní položku projektu akce v projektu SharePoint v experimentální instanci sady Visual Studio. Nakonec sestavte a spusťte projekt SharePoint, chcete-li ověřit, že vlastní akce funguje podle očekávání.

Spuštění ladění řešení

  1. Restartujte aplikaci Visual Studio s oprávněními správce a otevřete řešení CustomActionProjectItem.

  2. Otevřete soubor s kódem CustomAction a přidejte zarážku na první řádek kódu v metodě InitializeType.

  3. Stiskněte F5 pro spuštění ladění.

    Visual Studio nainstaluje rozšíření do %UserProfile%\AppData\Local\Microsoft\VisualStudio\10.0Exp\Extensions\Contoso\Custom Action Project Item\1.0 a spustí experimentální instanci Visual Studio. Položku projektu budete testovat v této instanci aplikace Visual Studio.

Chcete-li testovat položku projektu v aplikaci Visual Studio

  1. V experimentální instanci Visual Studio v nabídce Soubor vyberte Nový a potom klikněte na Projekt.

  2. Rozbalte Visual C# nebo Visual Basic (v závislosti na jazyku vaší šablony položky), rozbalte SharePoint a potom klikněte na tlačítko 2010.

  3. V seznamu šablon projektu klikněte na položku Prázdný projekt.

  4. Do pole Název zadejte text CustomActionTest.

  5. Klepněte na tlačítko OK.

  6. V Průvodce nastavením služby SharePoint zadejte adresu URL webu, který chcete použít k ladění a klikněte na tlačítko Dokonce.

  7. V Průzkumníku řešení klikněte pravým tlačítkem myši na uzel projektu, přejděte na Přidat, a pak klikněte na Nová položka.

  8. V dialogovém okně Přidat novou položku klikněte na uzel 2010 v rámci uzlu SharePoint.

    Ověřte, zda je položka Vlastní akce zobrazena v seznamu položek projektu.

  9. Klikněte na tlačítko Vlastní akce a potom klikněte na tlačítko Přidat.

    Visual Studio přidá novou položku s názvem CustomAction1 do projektu a otevře soubor Elements.xml v editoru.

  10. Ověřte, že se kód ve druhé instanci aplikace Visual Studio zastavil na zarážce, kterou jste nastavili výše v metodě InitializeType. Stisknutím F5 pokračujte v ladění projektu.

  11. V experimentální instanci aplikace Visual Studio v Průzkumníku řešení klikněte pravým tlačítkem myši na uzel CustomAction1 a klikněte na tlačítko Zobrazení návrháře vlastní akce. Ověřte, zda se zobrazí okno se zprávou a klepněte na tlačítko OK.

    Pomocí této místní nabídky můžete poskytnout další možnosti nebo příkazy pro vývojáře, jako je například zobrazení návrháře pro vlastní akci.

  12. V nabídce Zobrazit klepněte na příkaz Výstup.

    Otevře se okno Výstup.

  13. V Průzkumníku řešení klikněte pravým tlačítkem myši na položku CustomAction1 a změňte název, který má být MyCustomAction.

    Měla by se zobrazit zpráva potvrzení v okně Výstup; tato zpráva je zapsána obslužnou rutinou události ProjectItemNameChanged, kterou jste definovali ve třídě CustomActionProjectItemTypeProvider. Tuto událost lze zpracovávat a ostatní události položek projektu pro implementování vlastního chování, pokud vývojář upraví položku projektu.

Chcete-li testovat vlastní akce v SharePoint

  1. V experimentální instanci aplikace Visual Studio otevřete soubor Elements.xml, který je podřízený položky projektu MyCustomAction.

  2. V souboru Elements.xml proveďte následující změny:

    • V prvku CustomAction nastavte atribut Id na GUID nebo jiný jedinečný řetězec. Příklad:

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

    • V CustomAction prvku nastavena Title atributu takto:

      Title="SharePoint Developer Center"

    • V CustomAction prvku nastavena Description atributu takto:

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

    • V UrlAction prvku nastavena Url atributu takto:

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

  3. Uložte soubor Elements.xml.

  4. Stiskněte tlačítko F5. Vlastní akce je zabalena a nasazena na web služby SharePoint určený vlastností Adresa URL projektu. Webový prohlížeč otevře výchozí stránku tohoto webu.

    Poznámka

    Pokud se zobrazí dialogové okno Ladění skriptů zakázáno, klikněte na tlačítko Ano pro pokračování v ladění projektu.

  5. Klikněte na nabídku Akce serveru. Ověřte, že vlastní akce s názvem SharePoint Developer Center se zobrazí v dolní části této nabídky.

  6. Klikněte na položku nabídky SharePoint Developer Center. Ověřte, že prohlížeč otevře stránku https://msdn.microsoft.com/sharepoint/default.aspx.

  7. Zavřete webový prohlížeč.

Čištění vývojového počítače

Po dokončení testování projektu položky odeberte položku Šablona projektu z experimentálních instance aplikace Visual Studio.

Chcete-li vyčistit vývojový počítač

  1. V experimentální instanci Visual Studio v nabídce Nástroje klikněte na tlačítko Správce rozšíření.

    Otevře se okno Správce rozšíření.

  2. V seznamu rozšíření klikněte na Vlastní položka projektu akce a potom klikněte na Odinstalovat.

  3. V dialogovém okně, které se objeví, klikněte na tlačítko Ano pro potvrzení, že chcete odinstalovat rozšíření.

  4. Klikněte na Restartovat nyní pro dokonční odinstalace.

  5. Zavřete obě instance programu Visual Studio (experimentální instanci aplikace Visual Studio a instanci obsahující otevřené řešení CustomActionProjectItem).

Další kroky

Po dokončení tohoto postupu můžete přidat položku šablony průvodce. Při přidání vlastní akce projektu položky projektu, SharePoint, Průvodce shromažďuje informace o vlastní akci (například její umístění a vyhledejte po klepnutí na adresu URL) a přidá tyto informace do souboru Elements.xml v nové položce projektu. Další informace naleznete v tématu Podrobné pokyny: Vytvoření položky projektu vlastní akce položku šablony, část 2.

Viz také

Úkoly

Creating a New Bitmap or Other Image

Odkaz

Visual Studio šablona schéma Odkaz…

Image Editor

Koncepty

Pomocí služby SharePoint projektu

Další zdroje

Podrobné pokyny: Vytvoření položky projektu vlastní akce položku šablony, část 2

Definování vlastní typy položek projektu SharePoint

Vytváření položek projektu SharePoint položku šablony a šablony aplikace Project