Návod: Vytvoření vlastní položky projektu akce pomocí šablony položky, část 1

Článek
06/08/2015

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 SharePoint pro vlastní akci.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 Průzkumník řešení.
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 můžete vylepšit přidáním průvodce s šablonou položky položky projektu.Další informace naleznete v tématu Návod: Vytvoření vlastní položky projektu akce pomocí šablony položky, část 2.

[!POZNÁMKA]

Stáhnete vzorek, který obsahuje dokončených projektů, 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.
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 tématu Custom Action.
Šablony položek ve Visual Studio.Další informace naleznete v tématu Vytváření šablon pro projekty a položky v sadě 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 Visual Studio.
Na panelu nabídky vyberte možnosti Soubor, Nový, Projekt.
V seznamu v horní části Nový projekt dialogové okno pole, ujistěte se, že .NET Framework 4.5 je zaškrtnuto.
V Nový projekt dialogové okno pole, rozbalte položku Visual C# nebo jazyka Visual Basic uzly a pak zvolte rozšíření uzlu.

[!POZNÁMKA]

Uzel Rozšiřitelnost je k dispozici pouze v případě, že nainstalujete Visual Studio SDK.Další informace naleznete v oddílu požadavky dříve v tomto tématu.
Zvolte šablonu Projekt VSIX.
V jméno 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ík řešení, 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íObecné – Projekty a řešení – dialogové okno Možnosti.
V seznamu v horní části Nový projekt dialogové okno pole, ujistěte se, že .NET Framework 4.5 je zaškrtnuto.
V Nový projekt dialogové okno pole, rozbalte položku Visual C# nebo jazyka Visual Basic uzly a pak zvolte rozšíření uzlu.
Vyberte v seznamu šablon projektů C# šablonu položky nebo Šablonu položky Visual Basic šablony.
V jméno 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ík řešení, 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 zaškrtnuto.
V Nový projekt dialogové okno pole, rozbalte položku Visual C# nebo jazyka Visual Basic uzly, zvolte Windows uzlu a pak zvolte Knihovny tříd šablona projektu.
V jméno 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 služby SharePoint, je nutné přidat soubory kódu a odkazy na projekt sestavení.

Chcete-li konfigurovat projekt

V Průzkumník řešení, otevřete místní nabídku pro ProjectItemDefinition projektu, zvolte Přidat, pak zvolte Nové zboží.
V seznamu položek projektu, zvolte Kód souboru.
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ík řešení, otevřete místní nabídku ProjectItemDefinition projektu a poté vyberte Přidat odkaz.
V Reference Manager – ProjectItemDefinition dialogové okno pole, zvolte sestavení uzlu 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.

Definici nového typu položky projektu SharePoint

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

K definici nového typu 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ík řešení, 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, čímž zobrazíte Soubor ikony zboží.
V jméno 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ík řešení, zvolte CustomAction_SolutionExplorer.ico.
V Vlastnosti okna, zvolte na šipku vedle položky Akce sestavení vlastnost.
V zobrazeném seznamu zvolte Integrovaný prostředek.

Kontrolní bod

V tomto okamžiku návodu je celý kód pro položku projektu v projektu.Sestavte projekt, chcete-li ověřit, ž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 Odkaz na schéma šablon sady Visual Studio.

V Průzkumník řešení, otevřete místní nabídku ItemTemplate projektu, zvolte Přidata pak zvolte Novou položku.
V Přidat novou položku dialogové okno pole, zvolte Textový soubor šablony.
V jméno 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í dokumentace schématu položek projektu SharePoint.
V Průzkumník řešení, otevřete místní nabídku ItemTemplate projektu, zvolte Přidata pak zvolte Novou položku.
V Přidat novou položku dialogové okno pole, zvolte Soubor XML šablony.
V jméno 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 uvedené v UrlAction prvek otevře ve webovém prohlížeči.Další informace o prvcích XML můžete použít pro definování vlastní akce 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ík řešení, otevřete místní nabídku ItemTemplate projektu a poté vyberte Uvolnit projekt.
Otevření místní nabídky ItemTemplate projektu znovu a pak 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 prvek 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 šablona 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 uzlu a pak zvolte 2010 uzlu.
V Průzkumník řešení, otevřete místní nabídku ItemTemplate projektu a poté vyberte 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í.

Konfigurace a vytvoření balíčku VSIX

V Průzkumník řešení, otevřít místní nabídky 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 poli Autor napište Contoso.
V Popis zadejte položky projektu služby SharePoint, která představuje vlastní akci.
Na majetku , vyberte nové tlačítko.

Zobrazí se dialogové okno Přidat nové aktivum.
V typu seznam, zvolte Microsoft.VisualStudio.ItemTemplate.

[!POZNÁMKA]

Tato hodnota odpovídá prvku ItemTemplate v souboru extension.vsixmanifest.Tento prvek identifikuje podsložku v balíčku VSIX, který obsahuje šablonu položky projektu.Další informace naleznete v tématu ItemTemplate Element.
V seznamu Zdroje zvolte Projekt v aktuálním řešení.
V projektu seznam, zvolte ItemTemplatea pak zvolte OK tlačítko.
V majetku , vyberte nové tlačítko znovu.

Zobrazí se dialogové okno Přidat nové aktivum.
V seznamu Typ zvolte Microsoft.VisualStudio.MefComponent.

[!POZNÁMKA]

Tato hodnota odpovídá prvku MefComponent v souboru extension.vsixmanifest.Tento prvek určuje název sestavení rozšíření v balíčku VSIX.Další informace naleznete v tématu MEFComponent Element.
V seznamu Zdroje zvolte Projekt v aktuálním řešení.
V projektu seznam, zvolte ProjectItemDefinition.
Klikněte na tlačítko OK.
V řádku 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.

Výchozí výstupní složku sestavení je...\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 oprávněními správce a otevřete řešení CustomActionProjectItem.
Otevřete soubor s kódem CustomAction a přidejte zarážku do prvního řádku kódu v InitializeType metody.
Zvolte F5 klávesu ke 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.V této instanci aplikace Visual Studio bude testovat položku projektu.

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

V experimentální instanci Visual Studio na panelu nabídky zvolte Soubor, Nový, Projekt.
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 vyberte možnost Projekt SharePoint 2010.
V jméno zadejte CustomActionTesta pak zvolte OK tlačítko.
V SharePoint Průvodce přizpůsobením, zadejte adresu URL webu, který chcete použít pro ladění a pak vyberte Dokončit tlačítko.
V Průzkumník řešení, otevřete místní nabídku pro uzel projektu, zvolte Přidata pak zvolte Nové zboží.
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 bodu 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 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íč pro pokračování v ladění projektu.
V experimentální instanci Visual Studio v Průzkumník řešení, otevřete místní nabídku pro CustomAction1 uzlu a pak zvolte Zobrazení návrháře vlastní akce.
Ověřte, že se zobrazí okno se zprávou a potom 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.
V řádku nabídek zvolte zobrazení, výstup.

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

V výstup okno, zobrazí potvrzovací zpráva.Je autorem této zprávy 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žku projektu.
V souboru Elements.xml proveďte následující změny a poté soubor uložte:
- V CustomAction , nastavena Id atribut na GUID nebo jiný jedinečný řetězec, jak ukazuje následující příklad:
```
Id="cd85f6a7-af2e-44ab-885a-0c795b52121a"
```
- V CustomAction , nastavena Title atribut, jak ukazuje následující příklad:
```
Title="SharePoint Developer Center"
```
- V CustomAction , nastavena Description atribut, jak ukazuje následující příklad:
```
Description="Opens the SharePoint Developer Center Web site."
```
- V UrlAction , nastavena 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 uveden 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 se zobrazí dialogové okno, vyberte Ano tlačítko pro pokračování v ladění projektu.
Na Akce webu nabídky, zvolte SharePoint Developer Center, ověřte, že v prohlížeči se 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 aplikace Visual Studio.

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

V experimentální instanci Visual Studio na panelu nabídky zvolte Tools, Rozšíření a aktualizace.

Otevře se dialogové okno Aktualizace a rozšíření.
V seznamu přípon, zvolte Vlastní položku projektu akcea pak zvolte odinstalovat tlačítko.
V dialogovém okně, které se objeví, zvolte tlačítko Ano pro potvrzení, že chcete odinstalovat rozšíření.
Zvolením tlačítka Restartovat nyní dokončete odinstalaci.
Ukončete experimentální instanci aplikace Visual Studio a instanci, ve kterém je otevřené řešení CustomActionProjectItem.

Další kroky

Po dokončení tohoto návodu přidáte průvodce do šablony položky.Pokud uživatel přidá vlastní položky projektu akce do projektu SharePoint, Průvodce shromažďuje informace o akci (například její umístění a adresu URL přecházet, pokud je vybrána akce) a přidá tyto informace do souboru Elements.xml v nové položce projektu.Další informace naleznete v tématu Návod: Vytvoření vlastní položky projektu akce pomocí šablony položky, část 2.

Viz také

Sdílet prostřednictvím