Web bölümleri veya uygulama sayfaları için yeniden kullanılabilir denetimler oluşturma

Makale
05/01/2013

Visual Studio'da uygulama sayfaları ve SharePoint'te çalıştırılan Web bölümleri tarafından tüketilen özel, yeniden kullanılabilir denetimler oluşturabilirsiniz.Bu denetimleri, kullanıcı denetimleri olarak adlandırılır.Kullanıcı denetimleriyle ilgili daha fazla bilgi için, bkz. ASP.NET User Controls.

Kullanıcı denetimi oluşturma

Bir kullanıcı denetimi yaratmak için Ekle bir Bir kullanıcı denetimi için bir Boş SharePoint proje.Daha fazla bilgi için bkz. Nasıl yapılır: SharePoint uygulama sayfası veya Web Bölümü için bir kullanıcı denetimi yaratmak.

Eklediğinizde bir Kullanıcı denetimi madde, Visual Studio projenize bir klasör oluşturur ve sonra birkaç dosya klasörüne ekler.Her dosya aşağıdaki tabloda açıklanmaktadır.

Dosya	Tanımlama
Kullanıcı denetimi dosyası	Kullanıcı denetimi tanımlar.Bu dosyayı denetimleri ve biçimlendirme ekleyerek kullanıcı denetimi tasarlayabilirsiniz.
Kod dosyası	Kullanıcı denetimi arkasındaki kodu içerir.Olaylarını işlemek için bu dosyaya kod ekleyin.
Tasarımcı kod dosyası	Tasarımcısı tarafından yaratılan kodu içerir ve be doğrudan düzenlenemez.

Kullanıcı denetimi tasarlarken

Visual Studio Visual Web Developer tasarımcıyı kullanarak kullanıcı denetimi tasarlayabilirsiniz.Projenize kullanıcı denetimi dosyası açın ve Seç bu Tasarımcı görünür Tasarım sekme.Bu Tasarımcısı'nı kullanma hakkında daha fazla bilgi için bkz: Web içerik eşleme için Visual Studio 11 Beta.

Kullanıcı denetimi kullanma

Kullanıcı denetimleri, uygulama sayfası veya Web Bölümü dahil kadar SharePoint'te görünmez.

Dahil etmek için uygulama sayfasına kullanıcı denetimi eklemek bir @ Register uygulama sayfa yönergesi ve sonra sayfayı bir veya daha fazla içerik yer tutucuları içinde kullanıcı denetimi bildirin.Standart bir asp.net Web sayfasında bu görevi yerine getirmek nasıl bir örnek için bkz: How to: Include a User Control in an ASP.NET Web Page.

Web Bölümü'nde bir kullanıcı denetimi eklemek için Web Bölümü kullanıcı denetimi eklemek Controls Web Bölümü kod dosyasında koleksiyonu.Aşağıdaki örnek, bir kullanıcı denetimi ekler Controls Web Bölümü topluluğu.

<ToolboxItemAttribute(false)> _
Public Class VisualWebPart1
    Inherits WebPart

    Private Const _ascxPath As String = "~/_CONTROLTEMPLATES/VB/VisualWebPart1/VisualWebPart1UserControl.ascx"

    Public Sub New()
    End Sub

    Protected Overrides Sub CreateChildControls()
        Dim control As Control = Page.LoadControl(_ascxPath)
        Controls.Add(control)
        MyBase.CreateChildControls()
    End Sub

    Protected Overrides Sub RenderContents(ByVal writer As HtmlTextWriter)
        MyBase.RenderContents(writer)
    End Sub

End Class

[ToolboxItemAttribute(false)]
public class VisualWebPart1 : WebPart
{
    private const string _ascxPath = @"~/_CONTROLTEMPLATES/CS/VisualWebPart1/VisualWebPart1UserControl.ascx";

    public VisualWebPart1()
    {
    }

    protected override void CreateChildControls()
    {
        Control control = this.Page.LoadControl(_ascxPath);
        Controls.Add(control);
        base.CreateChildControls();
    }

    protected override void RenderContents(HtmlTextWriter writer)
    {
        base.RenderContents(writer);
    }

}

Bir kullanıcı denetimi hata ayıklama

Bir kullanıcı denetimi hata ayıklamak için kullanıcı denetimi bir uygulama sayfası veya Web Bölümü SharePoint projenizde eklendiğinden emin olun.Herhangi bir Visual Studio proje kodunda hata ayıklama gibi sonra kullanıcı denetimindeki kod ayıklayabilirsiniz.

Visual Studio hata ayıklayıcısını başlattığınızda, Visual Studio SharePoint sitesini açar.

SharePoint içinde kullanıcı denetimi içeren uygulama sayfayı açın.Kullanıcı denetimini bir Web Bölümü'nde bulunan bir SharePoint Web Bölümü sayfasına Web bölümü ekleyin.

SharePoint projelerinde hata ayıklama hakkında daha fazla bilgi için bkz: SharePoint çözümleri sorun giderme.

İlgili Konular

Başlık	Tanımlama
Nasıl yapılır: SharePoint uygulama sayfası veya Web Bölümü için bir kullanıcı denetimi yaratmak	Uygulama sayfaları ve SharePoint'te çalıştırılan Web bölümleri tarafından tüketilen özel, yeniden kullanılabilir denetimlerinin nasıl oluşturulduğunu gösterir.
Visual Web Developer ile çalışma	Projenizde bir Web sayfasını açtığınızda, tasarımcının nasıl kullanılacağı açıklanır.

Aracılığıyla paylaş