Instruktaż: Tworzenie elementu projektu działania niestandardowe z szablonu elementu, część 1

Artykuł
02/27/2013

System projektu programu SharePoint w programie Visual Studio można rozszerzyć, tworząc własny projekt typów elementów.W tym instruktażu będzie utworzyć element projektu, który można dodać do projektu programu SharePoint, aby utworzyć niestandardową akcję w witrynie programu SharePoint.Akcja niestandardowa dodaje element menu do Akcje witryny menu witryny programu SharePoint.

W tym instruktażu przedstawiono następujące zadania:

Tworzenie rozszerzeń programu Visual Studio, które definiuje nowy typ elementu projektu programu SharePoint dla akcji niestandardowej.Nowy typ elementu projektu implementuje kilka funkcji niestandardowych:
- Menu skrótów, który służy jako punkt wyjścia dla dodatkowych zadań związanych z element projektu, takie jak wyświetlanie projektanta dla akcji niestandardowej w Visual Studio.
- Kod, który jest uruchamiany, gdy projektant zmienia niektórych właściwości element projektu i projekt, który go zawiera.
- Ikonę niestandardową, który pojawia się obok elementu projektu w Solution Explorer.
Tworzenie szablonu elementu programu Visual Studio dla elementu projektu.
Budowanie pakietu Visual Studio rozszerzenie (VSIX) Aby wdrożyć szablon elementu projektu i montażu rozszerzenie.
Debugowanie i testowania element projektu.

Jest to autonomiczny instruktażu.Po wykonaniu tej procedury należy element projektu można zwiększyć przez dodanie kreatora w szablonie elementu.Aby uzyskać więcej informacji, zobacz Instruktaż: Tworzenie elementu projektu działania niestandardowe z szablonu elementu, część 2.

[!UWAGA]

Pobrać próbkę zawierającą zakończonych projektów, kod i inne pliki w tym instruktażu z następującej lokalizacji: https://go.microsoft.com/fwlink/?LinkId=191369.

Wymagania wstępne

Potrzebne są następujące składniki na komputerze deweloperskim do przeprowadzenia tego instruktażu:

Obsługiwane wersje systemu Microsoft Windows, programu SharePoint i Visual Studio.Aby uzyskać więcej informacji, zobacz Wymagania dotyczące rozwiązań programu SharePoint.
The Visual Studio SDK.W tym instruktażu wykorzystano Projektu VSIX szablon w zestawie SDK, aby utworzyć pakiet VSIX wdrożyć element projektu.Aby uzyskać więcej informacji, zobacz Rozszerzanie narzędzi programu SharePoint w programie Visual Studio.

Znajomość następujące pojęcia jest przydatne, ale nie jest to wymagane, aby ukończyć Instruktaż:

Akcje niestandardowe w programie SharePoint.Aby uzyskać więcej informacji, zobacz Akcji niestandardowej.
Szablony elementów w programie Visual Studio.Aby uzyskać więcej informacji, zobacz Wprowadzenie do programu Visual Studio, szablony.

Tworzenie projektów

Do przeprowadzenia tego instruktażu, należy utworzyć trzy projekty:

Projekt VSIX.Ten projekt tworzy pakiet VSIX wdrożyć element projektu programu SharePoint.
Element szablon projektu.Ten projekt tworzy szablon elementu, który służy do dodawania elementu projektu programu SharePoint do projektu programu SharePoint.
Projektu biblioteki klas.Ten projekt implementuje rozszerzenie programu Visual Studio, która definiuje zachowanie element projektu programu SharePoint.

Instruktaż należy rozpocząć od utworzenia projektów.

Aby utworzyć projekt VSIX

Start Visual Studio.
Na pasku menu wybierz pliku, Nowa, Projekt.
Na liście u góry Nowy projekt okno dialogowe pole, upewnij się, że 4.5.NET Framework jest zaznaczone.
W Nowy projekt okno dialogowe rozwiń Visual C# lub języka Visual Basic węzłów, a następnie wybierz polecenie rozszerzalności węzła.

[!UWAGA]

Rozszerzalności węzeł jest dostępne tylko po zainstalowaniu programu Visual Studio SDK.Aby uzyskać więcej informacji zobacz sekcję Warunki wstępne, wcześniej w tym temacie.
Wybierz Projektu VSIX szablonu.
W Nazwa wprowadź CustomActionProjectItem, a następnie wybierz polecenie OK przycisk.

Visual Studiododaje CustomActionProjectItem projekt Solution Explorer.

Aby utworzyć szablon projektu elementu

W Solution Explorer, otwórz menu skrótów dla węzła rozwiązanie, wybierz Dodaj, a następnie wybierz polecenie Nowy projekt.

[!UWAGA]

W projektach programu Visual Basic, węzeł rozwiązanie pojawia się w Solution Explorer tylko wtedy, gdy Zawsze pokazuj rozwiązanie pole wyboru jest zaznaczone w General, Projects and Solutions, Options Dialog Box.
Na liście u góry Nowy projekt okno dialogowe pole, upewnij się, że 4.5.NET Framework jest zaznaczone.
W Nowy projekt okno dialogowe rozwiń Visual C# lub języka Visual Basic węzłów, a następnie wybierz polecenie rozszerzalności węzła.
Na liście szablonów projektu, wybierz opcję Szablon elementu C# lub Szablon elementu języka Visual Basic szablonu.
W Nazwa wprowadź ItemTemplate, a następnie wybierz polecenie OK przycisk.

Visual Studiododaje ItemTemplate projektu do rozwiązania.

Aby utworzyć rozszerzenie projektu

W Solution Explorer, otwórz menu skrótów dla węzła rozwiązanie, wybierz Dodaj, a następnie wybierz polecenie Nowy projekt.
Na liście u góry Nowy projekt okno dialogowe pole, upewnij się, że 4.5.NET Framework jest zaznaczone.
W Nowy projekt okno dialogowe rozwiń Visual C# lub języka Visual Basic Wybierz węzły, Windows węzła, a następnie wybierz Biblioteka klas szablonu projektu.
W Nazwa wprowadź ProjectItemDefinition, a następnie wybierz polecenie OK przycisk.

Visual Studiododaje ProjectItemDefinition projektu do rozwiązania i otwiera plik domyślny kod Class1.
Usuń plik Class1 kodu z projektu.

Konfigurowanie rozszerzenie projektu

Można napisać kod, aby określić typ elementu projektu programu SharePoint, należy dodać pliki kodu i odwołania do zestawów do rozszerzenie projektu.

Aby skonfigurować projektu

W Solution Explorer, otwórz menu skrótów dla ProjectItemDefinition projektu, wybierz opcję Dodaj, a następnie wybierz polecenie Nowego elementu.
Na liście elementów projektu, wybierz opcję Kod pliku.
W Nazwa wprowadź nazwę Akcja niestandardowa z odpowiednie rozszerzenie nazwy pliku, a następnie wybierz Dodaj przycisk.
W Solution Explorer, otwórz menu skrótów dla ProjectItemDefinition projektu, a następnie wybierz Dodaj odwołanie.
W Reference Manager-ProjectItemDefinition okno dialogowe Wybierz zestawów węzła, a następnie wybierz polecenie RAM węzła.
Zaznacz pole wyboru obok każdego z następujących zestawów:
- System.ComponentModel.Composition
- System.Windows.Forms
Wybierz rozszerzenia węzła, zaznacz pole wyboru obok zestawu Microsoft.VisualStudio.Sharepoint, a następnie wybierz OK przycisk.

Definiowanie nowego typu element programu SharePoint projektu

Tworzenie klasy implementującej ISharePointProjectItemTypeProvider interfejsu, aby zdefiniować zachowanie nowy typ elementu projektu.Implementuje ten interfejs, w każdym przypadku, gdy chcesz zdefiniować nowy typ elementu projektu.

Aby zdefiniować nowy typ elementu programu SharePoint projektu

W programie project ProjectItemDefinition Otwórz plik kodu Akcja niestandardowa.

Zastąp kod w tym pliku następujący kod.

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

Tworzenie ikony dla elementu projektu w oknie Solution Explorer

Podczas tworzenia niestandardowego elementu projektu programu SharePoint można skojarzyć obrazu (ikony lub mapa bitowa) z elementu projektu.Ten obraz pojawia się obok elementu projektu w Solution Explorer.

W poniższej procedurze utworzyć ikonę elementu projektu i umieścić ikonę w zgromadzeniu rozszerzenie.Ta ikona jest wywoływany przez SharePointProjectItemIconAttribute z CustomActionProjectItemTypeProvider klasy, który został utworzony wcześniej.

Aby utworzyć niestandardową ikonę elementu projektu

W Solution Explorer, otwórz menu skrótów dla ProjectItemDefinition projektu, wybierz Dodaj, a następnie wybierz polecenie Nowy element....
Na liście elementów projektu, wybierz opcję Plik ikony przedmiotu.

[!UWAGA]

W projektach programu Visual Basic, należy wybrać Ogólne węzeł, aby wyświetlić Plik ikony przedmiotu.
W Nazwa wprowadź CustomAction_SolutionExplorer.ico, a następnie wybierz polecenie Dodaj przycisk.

Nowa ikona zostanie otwarty w Edytor obrazu.
Edytowanie wersji 16 x 16 pliku ikony tak, że projekt, można rozpoznać, a następnie zapisz plik ikony.
W Solution Explorer, wybierz opcję CustomAction_SolutionExplorer.ico.
W Właściwości okno, wybierz strzałkę znajdującą się obok Tworzenie akcji właściwość.
W wyświetlonej listy wybierz Zasobów osadzonych.

Punkt kontrolny

W tym momencie w instruktażu, cały kod dla elementu projektu jest teraz w projekcie.Utwórz projekt, aby zweryfikować, że skompilowany bez błędów.

Tworzenie projektu

Otwórz menu skrótów dla ProjectItemDefinition projekt i wybierz polecenie budować.

Tworzenie szablonu elementu Visual Studio

Aby włączyć inne programy do korzystania z przedmiotu projektu, należy utworzyć szablon projektu lub szablonu elementu.Deweloperzy używać tych szablonów w programie Visual Studio utworzyć wystąpienia przedmiotu projektu, przez utworzenie nowego projektu lub dodając element do istniejącego projektu.Do wykonania tej procedury należy użyć projektu ItemTemplate skonfigurować Twój przedmiot projektu.

Aby utworzyć szablon towaru

Usuń plik Class1 kodu z projektu ItemTemplate.
W projekcie ItemTemplate Otwórz plik ItemTemplate.vstemplate.

Zastąpić następujący kod XML, zawartość pliku, a następnie zapisz i zamknij plik.

[!UWAGA]

Następujący kod XML jest dla szablonu elementu Visual C#.Jeśli tworzysz szablon elementu języka Visual Basic, należy zastąpić wartość ProjectType element z 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>

Ten plik definiuje zawartość i zachowanie szablonie elementu.Aby uzyskać więcej informacji na temat zawartości tego pliku, zobacz Visual Studio szablonu schematu odwołania.

W Solution Explorer, otwórz menu skrótów dla ItemTemplate projektu, wybierz Dodaj, a następnie wybierz polecenie Nowego elementu.
W Dodaj nowy element okno dialogowe Wybierz Plik tekstowy szablonu.
W Nazwa wprowadź CustomAction.spdata, a następnie wybierz polecenie Dodaj przycisk.
Dodaj następujący kod XML do pliku CustomAction.spdata, a następnie zapisz i zamknij plik.
```
<?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>
```
Ten plik zawiera informacje o plikach, które są zawarte w elemencie projektu.Type Atrybut ProjectItem element musi być zestaw ten sam ciąg, który jest przekazywany do SharePointProjectItemTypeAttribute w definicji elementu projektu ( CustomActionProjectItemTypeProvider klasy utworzonej wcześniej w tym instruktażu).Aby uzyskać więcej informacji na temat zawartości plików, .spdata, zobacz Odwołanie schematu element projektu programu SharePoint.
W Solution Explorer, otwórz menu skrótów dla ItemTemplate projektu, wybierz Dodaj, a następnie wybierz polecenie Nowego elementu.
W Dodaj nowy element okno dialogowe Wybierz Pliku XML szablonu.
W Nazwa wprowadź Elements.xml, a następnie wybierz polecenie Dodaj przycisk.

Zastąpić następujący kod XML, zawartość pliku Elements.xml, a następnie zapisz i zamknij plik.

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

Ten plik definiuje domyślny akcji niestandardowej, która tworzy element menu na Akcje witryny menu witryny programu SharePoint.Gdy użytkownik wybierze element menu, adres URL określony w UrlAction element zostanie otwarty w przeglądarce sieci web.Aby uzyskać więcej informacji o elementy XML, można użyć do zdefiniowania akcji niestandardowej, zobacz Niestandardowe definicje działania.

Opcjonalnie Otwórz plik ItemTemplate.ico i zmodyfikować go tak, że projekt, który można rozpoznać.Ta ikona pojawi się obok elementu projektu w Dodaj nowy element okno dialogowe.
W Solution Explorer, otwórz menu skrótów dla ItemTemplate projektu, a następnie wybierz Unload projektu.
Otwórz menu skrótów dla ItemTemplate projekt ponownie, a następnie wybierz Edytować ItemTemplate.csproj lub ItemTemplate.vbproj edytować.
Zlokalizuj następujące VSTemplate elementu w pliku projektu.
```
<VSTemplate Include="ItemTemplate.vstemplate">
```
Zastąpić ten VSTemplate element z następujących XML, a następnie zapisz i zamknij plik.
```
<VSTemplate Include="ItemTemplate.vstemplate">
  <OutputSubPath>SharePoint\SharePoint14</OutputSubPath>
</VSTemplate>
```
OutputSubPath Element określa dodatkowe foldery w ścieżce, pod którym szablon elementu jest tworzony podczas tworzenia projektu.Foldery określone tutaj zapewnienia szablon elementu będą dostępne tylko wtedy, gdy klienci Otwórz Dodaj nowy element okno dialogowe rozwiń SharePoint węzła, a następnie wybierz 2010 węzła.
W Solution Explorer, otwórz menu skrótów dla ItemTemplate projektu, a następnie wybierz Projektu Reload.

Tworzenie elementu projektu wdrażania pakietu VSIX

Aby wdrożyć rozszerzenie, należy użyć projektu VSIX w swoje rozwiązanie tworzenia pakiet VSIX.Najpierw należy skonfigurować pakiet VSIX modyfikując plik source.extension.vsixmanifest, który jest zawarty w projekcie VSIX.Następnie utwórz pakiet VSIX przez budowania rozwiązania.

Aby skonfigurować i utworzyć pakiet VSIX

W Solution Explorer, otwórz menu skrótów dla source.extension.vsixmanifest plik w programie project CustomActionProjectItem, a następnie wybierz Otwórz.

Visual Studio otwiera plik w edytorze manifestu.Plik source.extension.vsixmanifest jest podstawą dla pliku extension.vsixmanifest, które wymagają wszystkie pakiety VSIX.Aby uzyskać więcej informacji na temat tego pliku, zobacz VSIX rozszerzenie schematu odwołania.
W Nazwa produktu wprowadź Element projektu Akcja niestandardowa.
W autora wprowadź Contoso.
W Opis wprowadź element projektu programu SharePoint, która reprezentuje akcji niestandardowej.
Na aktywów tab, wybrać Nowa przycisk.

Dodać nowego środka pojawi się okno dialogowe.
W typu listy, wybierz opcję Microsoft.VisualStudio.ItemTemplate.

[!UWAGA]

Wartość ta odpowiada ItemTemplate elementu w pliku extension.vsixmanifest.Ten element identyfikuje podfolder w pakiecie VSIX zawierający szablon elementu projektu.Aby uzyskać więcej informacji, zobacz ItemTemplate Element.
W źródło listy, wybierz opcję projektu w bieżącym rozwiązaniem.
W Projekt listy, wybierz opcję ItemTemplate, a następnie wybierz polecenie OK przycisk.
W aktywów tab, wybrać Nowa przycisk ponownie.

Dodać nowego środka pojawi się okno dialogowe.
W typu listy, wybierz opcję Microsoft.VisualStudio.MefComponent.

[!UWAGA]

Wartość ta odpowiada MefComponent elementu w pliku extension.vsixmanifest.Ten element Określa nazwę zestawu rozszerzeń w pakiecie VSIX.Aby uzyskać więcej informacji, zobacz MEFComponent Element.
W źródło listy, wybierz opcję projektu w bieżącym rozwiązaniem.
W Projekt listy, wybierz opcję ProjectItemDefinition.
Wybierz przycisk OK.
Na pasku menu wybierz budować, Budowania rozwiązania, a następnie upewnij się, że projekt kompiluje się bez błędów.
Upewnij się, że folder wyjściowy kompilacji dla projektu CustomActionProjectItem zawiera plik CustomActionProjectItem.vsix.

Domyślnie folder wyjściowy kompilacji jest...folder \bin\Debug w folderze, który zawiera projekt CustomActionProjectItem.

Testowanie element projektu

Teraz można przystąpić do badania element projektu.Po pierwsze rozpocząć debugowanie rozwiązanie CustomActionProjectItem w doświadczalnych wystąpienie programu Visual Studio.Następnie, test Akcji niestandardowej element projektu w projekcie programu SharePoint w doświadczalnych wystąpienie programu Visual Studio.Wreszcie budowy i uruchomienia projektu programu SharePoint, aby sprawdzić, czy akcja niestandardowa działa zgodnie z oczekiwaniami.

Aby rozpocząć debugowanie rozwiązanie

Uruchom ponownie program Visual Studio z poświadczeniami administracyjnymi, a następnie otwórz rozwiązanie CustomActionProjectItem.
Otwórz plik kodu Akcja niestandardowa, a następnie Dodaj punkt przerwania w pierwszej linii kodu w InitializeType metoda.
Wybierz F5 klawisz, aby rozpocząć debugowanie.

Visual Studio instaluje rozszerzenie do %UserProfile%\AppData\Local\Microsoft\VisualStudio\10.0Exp\Extensions\Contoso\Custom działania projektu Item\1.0 i uruchamia wystąpienie doświadczalnych Visual Studio.Element projektu będzie test w tym wystąpieniu programu Visual Studio.

Aby przetestować element projektu w programie Visual Studio

Eksperymentalne wystąpienie programu Visual Studio, na pasku menu wybierz pliku, Nowa, Projekt.
Rozwiń Visual C# lub programu Visual Basic (w zależności od języka obsługującego Twój szablon towaru), rozwiń węzeł SharePoint, a następnie wybierz polecenie 2010 węzła.
Na liście szablonów projektu, wybierz opcję Programu SharePoint 2010 projektu.
W Nazwa wprowadź CustomActionTest, a następnie wybierz polecenie OK przycisk.
W Kreatora dostosowania programu SharePoint, wprowadź adres URL witryny, którą chcesz używać do debugowania, a następnie wybierz wykończenie przycisk.
W Solution Explorer, otwórz menu skrótów dla węzła projektu, wybierz Dodaj, a następnie wybierz polecenie Nowego elementu.
W Dodaj nowy element okno dialogowe Wybierz 2010 węzeł SharePoint węzła.

Sprawdź, czy Akcji niestandardowej element, który pojawia się na liście elementów projektu.
Wybierz Akcji niestandardowej element, a następnie wybierz Dodaj przycisk.

Visual Studio dodaje element o nazwie CustomAction1 do projektu i otwiera plik Elements.xml, w edytorze.
Sprawdź, że kod w inne wystąpienie programu Visual Studio zatrzymuje się na punkt przerwania, które wcześniej w zestaw InitializeType metoda.
Wybierz F5 klawisz, aby kontynuować debugowania projektu.
Eksperymentalne wystąpienie programu Visual Studio w Solution Explorer, otwórz menu skrótów dla CustomAction1 węzła, a następnie wybierz Projektanta Akcja niestandardowa widoku.
Sprawdź, że pojawi się okno komunikatu, a następnie wybierz OK przycisk.

Można użyć tego menu skrótów, aby zapewnić dodatkowe opcje lub polecenia dla deweloperów, takie jak wyświetlanie projektanta dla akcji niestandardowej.
Na pasku menu wybierz Widok, produkcji.

Produkcji zostanie otwarte okno.
W Solution Explorer, otwórz menu skrótów dla CustomAction1 element, a następnie zmień jego nazwę, aby MyCustomAction.

W produkcji pojawia się komunikat potwierdzający okno.Ten komunikat jest zapisywany przez ProjectItemNameChanged obsługi zdarzeń zdefiniowanych w CustomActionProjectItemTypeProvider klasy.Można obsługiwać to zdarzenie i inne zdarzenia elementu projektu do zaimplementowania niestandardowych zachowań, gdy deweloper modyfikuje element projektu.

Aby przetestować akcji niestandardowej w programie SharePoint

W eksperymentalnych wystąpienie programu Visual Studio, otwórz plik Elements.xml, który jest elementem podrzędnym MyCustomAction element projektu.
W pliku Elements.xml należy wprowadzić następujące zmiany, a następnie zapisz plik:
- W CustomAction element, zestaw Id atrybut Identyfikator GUID lub unikatowy ciąg, jak pokazano w następującym przykładzie:
```
Id="cd85f6a7-af2e-44ab-885a-0c795b52121a"
```
- W CustomAction element, zestaw Title atrybut, jak pokazano w następującym przykładzie:
```
Title="SharePoint Developer Center"
```
- W CustomAction element, zestaw Description atrybut, jak pokazano w następującym przykładzie:
```
Description="Opens the SharePoint Developer Center Web site."
```
- W UrlAction element, zestaw Url atrybut, jak pokazano w następującym przykładzie:
```
Url="https://msdn.microsoft.com/sharepoint/default.aspx"
```
Wybierz klawisz F5.

Akcja niestandardowa jest pakowana i wdrożone w witrynie programu SharePoint, która jest określona w Adres URL witryny właściwości projektu.Otwiera przeglądarkę sieci web do domyślnej strony tej witryny.

[!UWAGA]

Jeśli Niepełnosprawnych debugowanie skryptu pojawi się okno dialogowe, wybierz opcję Tak przycisk, aby kontynuować debugowania projektu.
Na Akcje witryny menu, wybierz opcję Centrum deweloperów programu SharePoint, zweryfikować, że przeglądarka otwiera https://msdn.microsoft.com/sharepoint/default.aspx witryny sieci Web, a następnie zamknij przeglądarkę sieci web.

Oczyszczanie na komputerze deweloperskim

Po zakończeniu badania element projektu, należy usunąć szablon elementu projektu z eksperymentalnych wystąpienie programu Visual Studio.

Aby oczyścić komputer rozwoju

Eksperymentalne wystąpienie programu Visual Studio, na pasku menu wybierz Narzędzia, rozszerzenia i aktualizacje.

Rozszerzenia i aktualizacje zostanie otwarte okno dialogowe.
Na liście Rozszerzenia wybierz Element projektu Akcja niestandardowa, a następnie wybierz polecenie odinstalować przycisk.
W wyświetlonym oknie dialogowym wybierz Tak przycisk, aby potwierdzić, że chcesz odinstalować rozszerzenie.
Wybierz Uruchom ponownie teraz przycisk, aby zakończyć dezinstalację.
Zamknij doświadczalnych wystąpienie programu Visual Studio i instancji, w którym roztwór CustomActionProjectItem jest otwarty.

Następne kroki

Po wykonaniu tej procedury należy kreatora można dodać do szablonu elementu.Gdy użytkownik dodaje element projektu akcji niestandardowej do projektu programu SharePoint, Kreator zbiera informacje na temat działania (jak jego lokalizacja i adres URL, aby poruszać się po wybraniu akcji) i dodaje te informacje do pliku Elements.xml w nowym elemencie projektu.Aby uzyskać więcej informacji, zobacz Instruktaż: Tworzenie elementu projektu działania niestandardowe z szablonu elementu, część 2.

Zobacz też

Udostępnij za pośrednictwem