İzlenecek yol: Bölüm 1 bir öğe şablonu ile bir özel eylem proje öğesi oluşturma

Makale
02/26/2013

SharePoint proje sistemi Visual Studio'da öğesi türleri kendi projesi oluşturarak genişletebilirsiniz.Bu izlenecek yolda, bir SharePoint sitesinde bir özel eylemi oluþturmak için SharePoint projeye eklenen proje öğesi oluşturur.Özel eylem bir menü öğesi ekler Site eylemleri SharePoint sitesinin menüsü.

Bu izlenecek yolda aşağıdaki görevler gösterilir:

Visual Studio uzantısı oluşturma, yeni bir özel eylem için SharePoint proje öğesi türünü tanımlar.Yeni bir proje öğesi türü birkaç özel özellik uygular:
- Özel eylem için bir tasarımcı Visual Studio'da görüntüleme gibi proje öğesi ile ilgili ek görevler için başlangıç noktası görevi gören bir kısayol menüsü.
- Bir uygulama geliştiricisi belirli özellikler proje öğesi ve onu içeren proje değiştiğinde çalışan bir kod.
- Proje öğeyi yanında görüntülenen özel bir simge Çözüm Gezgini.
Proje öğesi için Visual Studio madde şablonu oluşturma.
Proje madde şablonu ve uzantısı derleme dağıtmak için Visual Studio Uzantısı (VSIX) paket oluşturma.
Hata ayıklama ve sınama proje öğesi.

Tek başına bir anlatım budur.Bu gidiş yolunu tamamladığınızda, proje öğesi Item template üzerine bir sihirbaz ekleyerek geliştirebilirsiniz.Daha fazla bilgi için bkz. İzlenecek yol: Bölüm 2 bir öğe şablonu ile bir özel eylem proje öğesi oluşturma.

[!NOT]

Tamamlanmış projeler, kod ve diğer dosyaları aşağıdaki konumdan Bu anlatım içeren bir örnek indirebilirsiniz: https://go.microsoft.com/fwlink/?LinkId=191369.

Önkoşullar

Geliştirme bilgisayarında Bu izlenecek yolu tamamlamak için aşağıdaki bileşenler gerekmektedir:

Microsoft Windows, SharePoint ve Visual Studio sürümleri desteklenir.Daha fazla bilgi için bkz. SharePoint çözümleri geliştirmek için gereksinimler.
Visual Studio SDK.Bu yönergelerde VSIX projesi SDK proje öğesi dağıtmak için VSIX paketi oluşturmak için şablon.Daha fazla bilgi için bkz. Visual Studio SharePoint araçları genişletme.

Yararlı, ancak gerekli değildir, izlenecek yolu tamamlamak için aşağıdaki kavramları hakkında bilgi:

Özel Eylemler SharePoint içinde.Daha fazla bilgi için bkz: Özel eylem.
Madde şablonu Visual Studio.Daha fazla bilgi için bkz. Visual Studio şablonları giriş.

Proje Oluşturma

Bu izlenecek yolu tamamlamak için üç proje oluşturmanız gerekir:

Bir VSIX proje.Bu proje SharePoint proje öğesi dağıtmak için VSIX paketi oluşturur.
Madde şablonu projesi.Bu projeyi bir SharePoint proje SharePoint proje öğesi eklemek için kullanılan bir öğe şablonu oluşturur.
Bir sınıf kitaplığı projesi.Bu proje SharePoint proje öğesi davranışını tanımlayan bir Visual Studio uzantısı uygular.

İzlenecek yol, projeler oluşturmaya başlayın.

VSIX projesi oluşturmak için

Visual Studio uygulamasını başlatın.
Menü çubuğunda Seç Dosya, Yeni, Proje.
Üst kısmındaki listeden Yeni bir proje iletişim kutusunda, aşağıdakilerden emin .net Framework 4.5 seçilir.
İçinde Yeni Proje iletişim kutusunda, genişletme Visual C# veya Visual Basic düğümler ve sonra seçin genişletilebilirlik düğümü.

[!NOT]

Genişletilebilirlik düğüm, Visual Studio sdk yüklüyorsanız kullanılabilir.Daha fazla bilgi için bu konudaki Önkoşullar bölümüne bakın.
Seçim VSIX projesi şablonu.
İçinde adı kutusuna girin CustomActionProjectItemve sonra Tamam düğmesi.

Visual Studioekler CustomActionProjectItem için proje Çözüm Gezgini.

Madde şablonu projesi oluşturmak için

İçinde Çözüm Gezgini, çözüm düğümüne kısayol menüsünü açın, seçim Ekleve sonra seçin Yeni bir proje.

[!NOT]

Visual Basic projesinde, çözüm düğümüne görünür Çözüm Gezgini sadece her zaman çözümü Göster onay kutusu seçildiğinde, General, Projects and Solutions, Options Dialog Box.
Üst kısmındaki listeden Yeni bir proje iletişim kutusunda, aşağıdakilerden emin .net Framework 4.5 seçilir.
İçinde Yeni Proje iletişim kutusunda, genişletme Visual C# veya Visual Basic düğümler ve sonra seçin genişletilebilirlik düğümü.
Proje şablonları listesinde seçim C# Item Template veya Madde şablonu Visual Basic şablonu.
İçinde adı kutusuna girin ItemTemplateve sonra Tamam düğmesi.

Visual Studioekler ItemTemplate projesi çözüme.

Uzantı projesi oluşturmak için

İçinde Çözüm Gezgini, çözüm düğümüne kısayol menüsünü açın, seçim Ekleve sonra seçin Yeni bir proje.
Üst kısmındaki listeden Yeni bir proje iletişim kutusunda, aşağıdakilerden emin .net Framework 4.5 seçilir.
İçinde Yeni Proje iletişim kutusunda, genişletme Visual C# veya Visual Basic düğümleri seçin Windows düğümü, ardından seçin Sınıf kitaplığı proje şablonu.
İçinde adı kutusuna girin ProjectItemDefinitionve sonra Tamam düğmesi.

Visual Studioekler ProjectItemDefinition projesi çözüme ve varsayılan Class1 kod dosyasını açar.
Projeden Class1 kod dosyasını silin.

Uzantı projesi yapılandırma

SharePoint proje öğesi türünü tanımlamak için kod yazmadan önce kod dosyaları ve derleme başvuruları uzantı projesine eklemeniz gerekir.

Projeyi Yapılandırma

İçinde Çözüm Gezgini, kısayol menüsünü açma ProjectItemDefinition projesi, seçim Ekle,'ı seçin Yeni madde.
Proje öğeleri listesinde seçim Kod dosyası.
İçinde adı kutusuna adı girin CustomAction uygun olan dosya adı uzantısı ve sonra Ekle düğmesi.
İçinde Çözüm Gezgini, kısayol menüsünü açma ProjectItemDefinition proje ve sonra Add Reference.
İçinde Reference Manager-ProjectItemDefinition iletişim kutusunda, Seç derlemeleri düğümü, ardından seçin Framework düğüm.
Her biri aşağıdaki derlemelere yanındaki onay kutusunu seçin:
- System.ComponentModel.Composition
- System.Windows.Forms
Seçim uzantıları düğümü, Microsoft.VisualStudio.Sharepoint derleme yanındaki onay kutusunu seçin ve sonra seçin Tamam düğmesi.

Yeni SharePoint proje öğesi türü tanımlama

Uygulayan bir sınıf oluşturmak ISharePointProjectItemTypeProvider yeni bir proje öğesi türü davranışını tanımlayan arabirim.Yeni bir proje öğesi tanımlamak istediğinizde bu arabirimi uygulayın.

Yeni SharePoint proje öğesi türünü tanımlamak için

ProjectItemDefinition projesinde özel kod dosyasını açın.

Bu dosyasındaki kodu aşağıdaki kodla değiştirin.

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

Çözüm Gezgini'nde proje öğesi için bir simge oluşturma

Özel bir SharePoint proje öğesi oluşturduğunuzda, görüntünün (simge veya bit eşlem) proje öğesi ile ilişkilendirebilirsiniz.Proje öğesi içinde yanında bu resmi görünür Çözüm Gezgini.

Aşağıdaki yordam, proje öğesi için bir simge oluşturmak ve simge uzantısı derlemeye gömmek.Bu simge tarafından başvurulan SharePointProjectItemIconAttribute , CustomActionProjectItemTypeProvider daha önce oluşturduğunuz sınıf.

Proje öğesi için özel bir simge oluşturmak için

İçinde Çözüm Gezgini, kısayol menüsünü açma ProjectItemDefinition projesi, seçim Ekleve sonra seçin Yeni öğe.
Proje öğeleri listesinde seçim Simge dosyası öğesi.

[!NOT]

Visual Basic projelerinde seçmelisiniz Genel görüntülenecek düğüm Simge dosyası öğesi.
İçinde adı kutusuna girin CustomAction_SolutionExplorer.icove sonra Ekle düğmesi.

Yeni simge açılır Resim Düzenleyicisi.
Tanımak ve sonra simge dosyasını kaydedin bir tasarımı olan dosya simgesi 16 x 16 sürümü düzenleyin.
İçinde Çözüm Gezgini, seçim CustomAction_SolutionExplorer.ico.
İçinde özellikleri penceresinde OK görüntülenmemesini Yapı eylemi özelliği.
Görüntülenen listeden seçin Gömülü Kaynak.

Checkpoint

Bu izlenecek yolda tüm proje öğesi şimdi projede kodudur.Yapı proje hatasız derlendiğinden emin olun.

Projenizi yapılandırmak için

Kısayol menüsünü açma ProjectItemDefinition 'ı seçin ve proje Yapı.

Visual Studio madde şablonu oluşturma

Diğer geliştiricilerin kendi Proje öğesini kullanmak için proje şablonu veya öğe şablonu oluşturmanız gerekir.Geliştiriciler bu şablonlar yeni bir proje oluşturmak veya varolan bir projeye bir öğe ekleyerek, proje öğesi örneğini oluşturmak için Visual Studio kullanın.Bu anlatım için ItemTemplate proje, proje öğesi yapılandırmak için kullanın.

Madde şablonu oluşturmak için

ItemTemplate projeden Class1 kod dosyasını silin.
ItemTemplate projesinde ItemTemplate.vstemplate dosyasını açın.

Aşağıdaki xml dosyasının içeriğini değiştirin ve kaydedin ve dosyayı kapatın.

[!NOT]

Aşağıdaki xml Visual C# öğeye yönelik bir şablondur.Visual Basic madde şablonu oluşturuyorsanız, değeri değiştirmek ProjectType öğe ile 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>

Bu dosyanın içeriğini ve Item template davranışını tanımlar.Bu dosyanın içeriği hakkında daha fazla bilgi için bkz: Visual Studio şablon şema başvurusu.

İçinde Çözüm Gezgini, kısayol menüsünü açmak ItemTemplate projesi, seçim Ekleve sonra seçin Yeni madde.
İçinde Add New Item iletişim kutusunda, seçim Metin dosyası şablonu.
İçinde adı kutusuna girin CustomAction.spdatave sonra Ekle düğmesi.
CustomAction.spdata dosyası için aşağıdaki XML'yi ekleyin ve kaydedin ve dosyayı kapatın.
```
<?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>
```
Bu dosya, proje öğede bulunan dosyalar hakkındaki bilgileri içerir.Type Özniteliği ProjectItem öğe ayarlayın, geçirilir aynı dize SharePointProjectItemTypeAttribute proje öğesi tanımı üzerinde ( CustomActionProjectItemTypeProvider Bu yönergede oluşturulmuş sınıf)..Spdata dosyaları içeriği hakkında daha fazla bilgi için bkz: SharePoint proje öğesi şema başvurusu.
İçinde Çözüm Gezgini, kısayol menüsünü açmak ItemTemplate projesi, seçim Ekleve sonra seçin Yeni madde.
İçinde Add New Item iletişim kutusunda, seçim xml dosyası şablonu.
İçinde adı kutusuna girin Elements.xmlve sonra Ekle düğmesi.

Elements.xml dosyasının içeriğini aşağıdaki xml ile değiştirin ve kaydedin ve dosyayı kapatın.

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

Bu dosya, bir menü öğesi oluşturur varsayılan özel eylem tanımlar Site eylemleri SharePoint sitesinin menüsü.Kullanıcı menü öğesi seçtiğinde, url belirtilen UrlAction öğesi web tarayıcısında açar.Bir özel eylemi tanımlamak için kullanabileceğiniz xml öğeleri hakkında daha fazla bilgi için bkz: Özel eylem tanımları.

İsteğe bağlı olarak, ItemTemplate.ico dosyasını açın ve anlayacağı şekilde bir tasarıma sahip olacak şekilde değiştirin.Proje öğesi içinde yanında bu simge görüntüler Add New Item iletişim kutusu.
İçinde Çözüm Gezgini, kısayol menüsünü açma ItemTemplate proje ve sonra Unload Project.
Kısayol menüsünü açma ItemTemplate yeniden proje ve sonra Düzenleme ItemTemplate.csproj veya Düzenleme ItemTemplate.vbproj.
Aşağıdaki bulmak VSTemplate proje dosyasındaki öğesi.
```
<VSTemplate Include="ItemTemplate.vstemplate">
```
Bunun yerine VSTemplate aşağıdaki xml ve sonra Kaydet ve Kapat dosya olan öğe.
```
<VSTemplate Include="ItemTemplate.vstemplate">
  <OutputSubPath>SharePoint\SharePoint14</OutputSubPath>
</VSTemplate>
```
OutputSubPath Öğesi altında madde şablonu oluşturulan Projeyi derlediğinizde yolunda ek klasörleri belirtir.Burada belirtilen klasörler yalnızca müşteriler açtığınızda öğe şablonu kullanılabilir olmasını sağlamak Add New Item iletişim kutusunda, genişletme SharePoint düğümü, ardından seçin 2010 düğüm.
İçinde Çözüm Gezgini, kısayol menüsünü açma ItemTemplate proje ve sonra Projeyi yeniden yükle.

Proje öğesi dağıtmak için VSIX paketi oluşturma

Uzantıyı dağıtmak için VSIX paketi oluşturmak için çözümünüzdeki VSIX projesi kullanın.İlk olarak, VSIX projesinde bulunan source.extension.vsixmanifest dosyasını değiştirerek VSIX paketi yapılandırın.Ardından, çözüm oluşturma tarafından VSIX paketi oluşturun.

VSIX paketi oluşturmak ve yapılandırmak için

İçinde Çözüm Gezgini, kısayol menüsünü açmak source.extension.vsixmanifest CustomActionProjectItem projede dosya ve sonra açmak.

Visual Studio, dosya bildirim düzenleyicisinde açılır.Source.extension.vsixmanifest dosya tüm VSIX paketi gerektirir extension.vsixmanifest dosya temelini oluşturur.Bu dosya hakkında daha fazla bilgi için bkz: VSIX uzantı Şeması Başvurusu.
İçinde Product Name kutusuna girin Özel eylem proje öğesi.
İçinde Yazar kutusuna girin Contoso.
İçinde Açıklama kutusuna girin a SharePoint proje öğesi temsil eden bir özel eylem.
Üzerinde varlıklarını sekmesinde, seçim Yeni düğmesi.

Yeni kıymet eklemek iletişim kutusu görüntülenir.
İçinde türü listesinde, seçim Microsoft.VisualStudio.ItemTemplate.

[!NOT]

Bu değeri karşılık gelen ItemTemplate extension.vsixmanifest dosyasındaki öğesi.VSIX paketinde proje öğe şablonu içeren alt klasörü bu öğeyi tanımlar.Daha fazla bilgi için bkz. ItemTemplate Element.
İçinde kaynak listesinde, seçim Geçerli çözümde bir proje.
İçinde Proje listesinde, seçim ItemTemplateve sonra seçin Tamam düğmesi.
İçinde varlıklarını sekmesinde, seçim Yeni düğmesini yeniden tıklatın.

Yeni kıymet eklemek iletişim kutusu görüntülenir.
İçinde türü listesinde, seçim Microsoft.VisualStudio.MefComponent.

[!NOT]

Bu değeri karşılık gelen MefComponent extension.vsixmanifest dosyasındaki öğesi.Bu öğe, VSIX paketinde uzantısı derlemenin adını belirtir.Daha fazla bilgi için bkz. MEFComponent Element.
İçinde kaynak listesinde, seçim Geçerli çözümde bir proje.
İçinde Proje listesinde, seçim ProjectItemDefinition.
Tamam düğmesini seçin.
Menü çubuğunda Seç Yapı, Build Solutionve sonra projeyi hatasız derlendiğinden emin olun.
CustomActionProjectItem projenin yapı çıktı klasörüne CustomActionProjectItem.vsix dosyası içerdiğinden emin olun.

Varsayılan olarak, yapı çıktı klasörüne değil...CustomActionProjectItem projesini içeren klasörü altındaki \bin\Debug klasörünü.

Proje öğesi sınama

Proje öğesini test etmek artık hazırsınız.İlk olarak, Visual Studio'nun deneysel örneği CustomActionProjectItem çözümünde hata ayıklamayı Başlat.Sonra test Özel eylem Visual Studio'nun deneysel örneği SharePoint projede proje öğesi.Son olarak, yapı ve özel eylem beklendiği gibi çalıştığını doğrulamak için SharePoint projeyi çalıştırın.

Çözümün hatasını ayıklamayı başlatmak için

Yönetici kimlik bilgileriyle Visual Studio'yu yeniden başlatın ve CustomActionProjectItem çözüm açın.
Özel kod dosyasını açın ve sonra kodu ilk satırı için bir kesme noktası ekleyebilir InitializeType yöntem.
Seçim F5 hata ayıklamayı başlatma anahtarı.

Visual Studio uzantısı %UserProfile%\AppData\Local\Microsoft\VisualStudio\10.0Exp\Extensions\Contoso\Custom eylem proje Item\1.0 yükler ve Visual Studio'nun deneysel örneği başlar.Visual Studio'nun bu örneği proje öğesi test.

Visual Studio'da Proje öğesi sınamak için

Visual Studio'nun deneysel örneği menü çubuğunda seçin Dosya, Yeni, Proje.
Genişletme Visual C# veya Visual Basic (madde şablonunuzu destekleyen diline bağlı olarak) genişletin SharePointve sonra seçin 2010 düğümü.
Proje şablonları listesinde seçim SharePoint 2010 proje.
İçinde adı kutusuna girin CustomActionTestve sonra Tamam düğmesi.
İçinde SharePoint Özelleştirme Sihirbazı, hata ayıklama için kullanmak istediğiniz sitenin URL'sini girin ve sonra'ı Son düğmesi.
İçinde Çözüm Gezgini, proje düğümü için kısayol menüsünü açın, seçim Ekleve sonra Yeni öğe.
İçinde Add New Item iletişim kutusunda, seçim 2010 düğümü altında SharePoint düğümü.

Doğrulayın Özel eylem öğesi, proje öğeler listesinde görüntülenir.
Seçim Özel eylem öğesini ve sonra Ekle düğmesi.

Visual Studio adlı bir öğe ekler CustomAction1 proje ve Elements.xml dosyasını düzenleyicide açar.
Visual Studio'nun diğer örnek kod, daha önce ayarladığınız kesme noktası durduðunu doðrulamak InitializeType yöntem.
Seçim F5 projede hata ayıklamaya devam etmek için tuşa.
Visual Studio'nun deneysel örneğinde, Çözüm Gezgini, kısayol menüsünü açmak CustomAction1 düğümü ve sonra seçin Özel eylem tasarımcıyı.
Bir ileti kutusu görünür ve sonra seçin doğrulayın Tamam düğmesi.

Bu kısayol menüsünü görüntüleyen özel eylem için bir tasarımcı gibi geliştiriciler, ek seçenekler veya komutlar sağlamak için kullanabilirsiniz.
Menü çubuğunda Seç Görünüm, Çıkış.

Çıkış penceresi açılır.
İçinde Çözüm Gezgini, kısayol menüsünü açma CustomAction1 madde ve onun adını değiştirin MyCustomAction.

İçinde Çıkış penceresinde, bir onay iletisi görünür.Bu ileti tarafından yazılan ProjectItemNameChanged içinde tanımlanan olay işleyicisi CustomActionProjectItemTypeProvider sınıf.Bu olay ve geliştirici proje öğesi değiştirdiğinde, özel davranışı uygulamak için diğer proje öðesi olaylarý işleyebilir.

Özel eylemi SharePoint'te sınamak için

Visual Studio'nun deneysel örneği alt Elements.xml dosyasını MyCustomAction proje öğesi.
Elements.xml dosyasında aşağıdaki değişiklikleri yapın ve sonra dosyayı kaydedin:
- İçinde CustomAction öğesinde ayarlanmış Id aşağıdaki örnekte gösterildiği gibi bir GUID ya da başka bir benzersiz dize özniteliği:
```
Id="cd85f6a7-af2e-44ab-885a-0c795b52121a"
```
- İçinde CustomAction öğesinde ayarlanmış Title özniteliği aşağıdaki örnekte gösterildiği gibi:
```
Title="SharePoint Developer Center"
```
- İçinde CustomAction öğesinde ayarlanmış Description özniteliği aşağıdaki örnekte gösterildiği gibi:
```
Description="Opens the SharePoint Developer Center Web site."
```
- İçinde UrlAction öğesinde ayarlanmış Url özniteliği aşağıdaki örnekte gösterildiği gibi:
```
Url="https://msdn.microsoft.com/sharepoint/default.aspx"
```
F5 tuşuna basarak seçin.

Özel eylem paketlenmiş ve belirtilen SharePoint sitesine dağıtılan Site URL'si projesinin özelliği.Bu sitenin varsayılan sayfa web tarayıcısında açılır.

[!NOT]

Komut dosyası hata ayıklamasını devre Seç iletişim kutusu görüntülenirse, Evet projede hata ayıklamaya devam etmek için '.
Üzerinde Site eylemleri menüsünden seçin SharePoint Geliştirici Merkezitarayıcı Web sitesi https://msdn.microsoft.com/sharepoint/default.aspx doğrulamak ve sonra web tarayıcısını kapatın.

Geliştirme bilgisayarı temizleme

Proje öğesi sınamayı tamamladıktan sonra Visual Studio'nun deneysel örneği proje öğe şablonu kaldırın.

Geliştirme bilgisayarı temizlemek için

Visual Studio'nun deneysel örneği menü çubuğunda seçin araçları, uzantıları ve güncelleştirmeleri.

Uzantıları ve güncelleştirmeleri iletişim kutusunu açar.
Uzantılar listesinde seçim Özel eylem proje öğesive sonra seçin kaldırma düğmesi.
Görüntülenen iletişim kutusunda seçtiğiniz Evet uzantıyı kaldırmak istediğinizi onaylamak için düğme.
Seçim Şimdi yeniden kaldırma işlemi tamamlamak için düğme.
Visual Studio'nun deneysel örneği hem de CustomActionProjectItem çözüm açık örneğini kapatın.

Sonraki Adımlar

Bu gidiş yolunu tamamladığınızda, sihirbaz bir madde şablonu ekleyebilirsiniz.Bir kullanıcı SharePoint proje için bir özel eylem proje madde eklediğinde, sihirbaz eylemi (örneğin, konumuna ve eylem seçildiğinde gitmek üzere url) hakkında bilgi toplar ve bu bilgileri Elements.xml dosyasına yeni bir proje öğesi olarak ekler.Daha fazla bilgi için bkz. İzlenecek yol: Bölüm 2 bir öğe şablonu ile bir özel eylem proje öğesi oluşturma.

Ayrıca bkz.

Aracılığıyla paylaş