Názorný postup: Vytváření projektu vlastní akci pomocí položky šablony, část 1

Článek
03/04/2013

Vytvořením vlastního projektu typu položky můžete rozšířit systém projektu služby SharePoint v aplikaci Visual Studio.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í aplikace Visual Studio, která definuje nový typ položky projektu služby SharePoint pro vlastní akci.Nový typ položky projektu implementuje několik vlastní 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 Průzkumníku.
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.

Je to samostatný návod.Po dokončení tohoto návodu přidáte průvodce do šablony položky můžete vylepšit položky projektu.Další informace naleznete v tématu Názorný postup: Vytváření projektu vlastní akci pomocí položky šablony, část 2.

[!POZNÁMKA]

Stáhnout vzorek, který obsahuje dokončené projekty, kód a další soubory v tomto návodu 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:

Podporované vydání systému Microsoft Windows, SharePoint a Visual Studio.Další informace naleznete v tématu Požadavky na vývoj řešení služby SharePoint.
Rozhraní Visual Studio SDK.Tento návod používá šablonu Projekt VSIX v sadě SDK pro vytvoření balíčku VSIX k nasazení položky projektu.Další informace naleznete v tématu Rozšíření nástrojů SharePoint v aplikaci Visual Studio.

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

Vlastní akce ve službě SharePoint.Další informace naleznete v Vlastní akce.
Šablony položek ve Visual Studio.Další informace naleznete v tématu Úvod k šablonám aplikace Visual Studio.

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

Spusťte nástroj Visual Studio.
Na panelu nabídek zvolte soubor, Nový, projektu.
V seznamu v horní části Nový projekt dialogové okno pole, ujistěte se, že .NET Framework 4.5 je vybrán.
V Nový projekt dialogové okno pole, rozbalte položku Visual C# nebo jazyka Visual Basic uzly a pak zvolte rozšíření uzlu.

[!POZNÁMKA]

Rozšíření uzel je k dispozici pouze v případě, že nainstalujete Visual Studio SDK.Další informace naleznete v části požadavky dříve v tomto tématu.
Zvolte Projektu VSIX šablony.
V název zadejte CustomActionProjectItema pak zvolte OK tlačítko.

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

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

V Průzkumníku, otevřete místní nabídku pro uzel řešení, zvolte Přidata pak zvolte 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íGeneral, Projects and Solutions, Options Dialog Box.
V seznamu v horní části Nový projekt dialogové okno pole, ujistěte se, že .NET Framework 4.5 je vybrán.
V Nový projekt dialogové okno pole, rozbalte položku Visual C# nebo jazyka Visual Basic uzly a pak zvolte rozšíření uzlu.
V seznamu šablon projektu, zvolte C# šablonu položky nebo Šablonu položky Visual Basic šablony.
V název zadejte ItemTemplatea pak zvolte OK tlačítko.

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

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

V Průzkumníku, otevřete místní nabídku pro uzel řešení, zvolte Přidata pak zvolte Nový projekt.
V seznamu v horní části Nový projekt dialogové okno pole, ujistěte se, že .NET Framework 4.5 je vybrán.
V Nový projekt dialogové okno pole, rozbalte položku Visual C# nebo jazyka Visual Basic Zvolte uzly, Windows uzel a pak zvolte Knihovny tříd šablony projektu.
V název zadejte ProjectItemDefinitiona pak zvolte OK tlačítko.

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

Konfigurace projektu rozšíření

Před napsáním kódu pro definování typu položky projektu SharePoint, musíte přidat soubory kódu a odkazy na projekt sestavení.

Chcete-li konfigurovat projekt

V Průzkumníku, otevřete místní nabídku pro ProjectItemDefinition projektu, zvolte Přidat, pak zvolte Nová položka.
V seznamu položek projektu, zvolte Soubor kódu.
V název zadejte název CustomAction s příslušnou příponu názvu souboru a pak zvolte Přidat tlačítko.
V Průzkumníku, otevřete místní nabídku ProjectItemDefinition projektu a zvolte Přidat odkaz.
V Reference Manager-ProjectItemDefinition dialogové okno pole, zvolte sestavení uzel a pak zvolte Framework uzlu.
Zaškrtněte políčko vedle každé následující sestavení:
- System.ComponentModel.Composition
- System.Windows.Forms
Zvolte rozšíření uzel, zaškrtněte políčko vedle sestavení Microsoft.VisualStudio.Sharepoint a pak zvolte OK tlačítko.

Definování nového typu položky projektu SharePoint

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

Chcete-li definovat nový typ položky projektu SharePoint

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

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

V Průzkumníku, otevřete místní nabídku ProjectItemDefinition projektu, zvolte Přidata pak zvolte Novou položku....
V seznamu položek projektu, zvolte Soubor ikony zboží.

[!POZNÁMKA]

Projekty jazyka Visual Basic, je třeba zvolit Obecné uzel Soubor ikony zboží.
V název zadejte CustomAction_SolutionExplorer.icoa pak zvolte Přidat tlačítko.

Nová ikona se otevře v Editoru obrázků.
Upravte 16x16 verzi souboru ikony tak, aby měla vyhovující vzor a potom uložte soubor ikony.
V Průzkumníku, zvolte CustomAction_SolutionExplorer.ico.
V Vlastnosti okna, zvolte na šipku vedle Akce sestavení vlastnost.
V zobrazeném seznamu zvolte Integrovaný prostředek.

Checkpoint

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

Chcete-li sestavit projekt

Otevření místní nabídky ProjectItemDefinition projektu a zvolte sestavení.

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

Odstraňte soubor kódu Class1 z projektu ItemTemplate.
V projektu ItemTemplate otevřete soubor ItemTemplate.vstemplate.

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.

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

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

V Průzkumníku, otevřete místní nabídku pro ItemTemplate projektu, zvolte Přidata pak zvolte Nová položka.
V Přidat novou položku dialogovém okně zvolte Textový soubor šablony.
V název zadejte CustomAction.spdataa pak zvolte Přidat tlačítko.
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.
V Průzkumníku, otevřete místní nabídku pro ItemTemplate projektu, zvolte Přidata pak zvolte Nová položka.
V Přidat novou položku dialogovém okně zvolte Soubor XML šablony.
V název zadejte Elements.xmla pak zvolte Přidat tlačítko.

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 vybere položku nabídky, adresa URL zadané v UrlAction element se otevře ve webovém prohlížeči.Další informace o prvcích XML můžete definovat vlastní akce, viz Definice vlastní akce.

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.
V Průzkumníku, otevřete místní nabídku ItemTemplate projektu a pak zvolte Uvolnit projekt.
Otevření místní nabídky ItemTemplate projektu znovu a zvolte Úprava ItemTemplate.csproj nebo Úprava ItemTemplate.vbproj.
Najděte následující prvek VSTemplate v souboru projektu.
```
<VSTemplate Include="ItemTemplate.vstemplate">
```
Nahraďte tento VSTemplate element s následujícím XML a potom uložit a zavřít soubor.
```
<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í, že šablonu položky budou k dispozici pouze v případě, že otevřete zákazníky Přidat novou položku dialogové okno pole, rozbalte položku SharePoint uzel a pak zvolte 2010 uzlu.
V Průzkumníku, otevřete místní nabídku ItemTemplate projektu a pak zvolte 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

V Průzkumníku, otevřete místní nabídku source.extension.vsixmanifest souboru v projektu CustomActionProjectItem a pak zvolte otevřete.

Visual Studio otevře soubor v editoru manifestu.Soubor source.extension.vsixmanifest je základem pro soubor extension.vsixmanifest, který vyžadují všechny balíčky VSIX.Další informace o tomto souboru získáte v tématu VSIX rozšíření schématu Reference.
V Název produktu zadejte Vlastní položku projektu akce.
V Autor zadejte Contoso.
V Popis zadejte položky projektu služby SharePoint, která představuje vlastní akci.
Na majetku , vyberte Nový tlačítko.

Přidat nový majetek zobrazí se dialogové okno.
V typu seznam, zvolte Microsoft.VisualStudio.ItemTemplate.

[!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.
V zdroje seznam, zvolte projektu v aktuálním řešení.
V projektu seznam, zvolte ItemTemplatea pak zvolte OK tlačítko.
V majetku , vyberte Nový znovu na tlačítko.

Přidat nový majetek zobrazí se dialogové okno.
V typu seznam, zvolte Microsoft.VisualStudio.MefComponent.

[!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.
V zdroje seznam, zvolte projektu v aktuálním řešení.
V projektu seznam, zvolte ProjectItemDefinition.
Klikněte na tlačítko OK.
Na panelu nabídek zvolte sestavení, Sestavit řešenía ujistěte se, že projekt zkompiluje bez chyb.
Ujistěte se, že výstupní složku sestavení pro projekt CustomActionProjectItem 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í

Restartujte aplikaci Visual Studio s pověřeními pro správu a otevřete řešení CustomActionProjectItem.
Otevřete soubor kódu CustomAction a přidejte zarážku do prvního řádku kódu v InitializeType metoda.
Zvolte F5 klíč 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

V experimentální instanci Visual Studio v řádku nabídek zvolte soubor, Nový, projektu.
Rozbalte Visual C# nebo jazyka Visual Basic (v závislosti na jazyk, který podporuje šablony položky), rozbalte položku SharePointa pak zvolte 2010 uzlu.
V seznamu šablon projektu zvolte Projektu služby SharePoint 2010.
V název zadejte CustomActionTesta pak zvolte OK tlačítko.
V SharePoint Průvodce vlastním nastavením, zadejte adresu URL webu, který chcete použít pro ladění a pak zvolte Dokončit tlačítko.
V Průzkumníku, otevřete místní nabídku pro uzel projektu, zvolte Přidata pak zvolte Nová položka.
V Přidat novou položku dialogové okno pole, zvolte 2010 uzlu SharePoint uzlu.

Ověřte, zda je položka Vlastní akce zobrazena v seznamu položek projektu.
Zvolte Vlastní akce položky a pak zvolte Přidat tlačítko.

Visual Studio přidá položku s názvem CustomAction1 do projektu a otevře soubor Elements.xml v v editoru.
Ověřte, že se kód ve druhé instanci aplikace Visual Studio zastavil na zarážce, kterou jste nastavili výše v metodě InitializeType.
Zvolte F5 klíč pokračovat v ladění projektu.
V experimentální instanci Visual Studio v Průzkumníku, otevřete místní nabídku pro CustomAction1 uzel a pak zvolte Zobrazení návrháře vlastní akce.
Ověřte, zda se zobrazí okno zprávy a zvolte OK tlačítko.

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.
Na panelu nabídek zvolte zobrazení, výstup.

Otevře se okno Výstup.
V Průzkumníku, otevřete místní nabídku pro CustomAction1 položku a změňte jeho název na MyCustomAction.

V výstup okna, o potvrzení.Tato zpráva je zapsána ve ProjectItemNameChanged obslužnou rutinu události, kterou jste definovali v CustomActionProjectItemTypeProvider třídy.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

V experimentální instanci aplikace Visual Studio otevřete soubor Elements.xml, který je podřízeným MyCustomAction položky projektu.
V souboru Elements.xml proveďte následující změny a uložte soubor:
- V CustomAction prvku, nastavte Id atribut GUID nebo jiný jedinečný řetězec jako v následujícím příkladu:
```
Id="cd85f6a7-af2e-44ab-885a-0c795b52121a"
```
- V CustomAction prvku, nastavte Title atribut, jak ukazuje následující příklad:
```
Title="SharePoint Developer Center"
```
- V CustomAction prvku, nastavte Description atribut, jak ukazuje následující příklad:
```
Description="Opens the SharePoint Developer Center Web site."
```
- V UrlAction prvku, nastavte Url atribut, jak ukazuje následující příklad:
```
Url="https://msdn.microsoft.com/sharepoint/default.aspx"
```
Zvolte klávesu F5.

Vlastní akce je zabaleny a nasazeny na web služby SharePoint, který je určen v Adresa URL webu vlastností projektu.Webový prohlížeč otevře výchozí stránku tohoto webu.

[!POZNÁMKA]

Pokud Ladění skriptů zakázáno dialogovém okně zvolte Ano tlačítko Pokračovat v ladění projektu.
Na Akce webu nabídce zvolte SharePoint Developer Center, ověřte, že prohlížeč otevře web https://msdn.microsoft.com/sharepoint/default.aspx a potom zavřete webový prohlížeč.

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

Po dokončení testování položky projektu odeberte šablonu položky projektu v experimentální instanci Visual Studio.

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

V experimentální instanci Visual Studio v řádku nabídek zvolte Nástroje, aktualizace a rozšíření.

Aktualizace a rozšíření dialogové okno.
V seznamu rozšíření zvolte Vlastní položku projektu akcea pak zvolte Odinstalace tlačítko.
V dialogovém okně, které se objeví, zvolte Ano tlačítko potvrďte, že chcete odinstalovat rozšíření.
Zvolte Restartovat nyní tlačítko pro dokonční odinstalace.
Ukončete experimentální instanci aplikace Visual Studio a instanci Otevřete CustomActionProjectItem řešení.

Další kroky

Po dokončení tohoto návodu přidáte průvodce do šablony položky.Při přidání vlastní položky projektu akce do projektu SharePoint průvodce shromažďuje informace o akci (například její umístění a URL přejděte při zvolené akce) a přidá tyto informace do souboru Elements.xml v nové položky projektu.Další informace naleznete v tématu Názorný postup: Vytváření projektu vlastní akci pomocí položky šablony, část 2.

Viz také

Sdílet prostřednictvím