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

Visual Studio'da, SharePoint'te çalışan uygulama sayfaları ve Web Bölümleri tarafından kullanılabilecek özel, yeniden kullanılabilir denetimler oluşturabilirsiniz. Bu denetimler kullanıcı denetimleri olarak adlandırılır. Kullanıcı denetimi, ASP.NET Web sayfasına çok benzer şekilde çalışan bir bileşik denetim türüdür. Mevcut Web sunucusu denetimlerini ve işaretlemelerini bir kullanıcı denetimine ekleyebilir ve denetimin özelliklerini ve yöntemlerini tanımlayabilirsiniz. Daha sonra bunları ASP.NET Web sayfalarına ekleyebilirsiniz; burada birim görevi görürler.

Kullanıcı denetimi oluşturma

Kullanıcı denetimi oluşturmak için Boş Bir SharePoint Projesine Kullanıcı Denetimi ekleyin. Daha fazla bilgi için bkz . Nasıl yapılır: SharePoint uygulaması sayfası veya web bölümü için kullanıcı denetimi oluşturma.

Kullanıcı Denetimi öğesi eklediğinizde, Visual Studio projenizde bir klasör oluşturur ve ardından klasöre birkaç dosya ekler. Aşağıdaki tabloda her dosya açıklanmaktadır.

Kullanıcı denetimini tasarlama

Visual Studio'da Visual Web Geliştirici tasarımcısını kullanarak kullanıcı denetimini tasarlayın. Projenizde kullanıcı denetim dosyasını açıp Tasarım sekmesini seçtiğinizde bu tasarımcı görüntülenir.

Kullanıcı denetimini kullanma

Kullanıcı denetimleri, siz bir uygulama sayfasına veya Web Bölümüne ekleyene kadar SharePoint'te görünmez.

Uygulama sayfasına kullanıcı denetimi eklemek için, ASP.NET kullanıcı denetimini eklemek istediğiniz Web sayfasını açın. Tasarım görünümüne geçin, ardından Çözüm Gezgini özel kullanıcı denetimi dosyanızı seçin ve sayfaya sürükleyin. ASP.NET kullanıcı denetimi sayfaya eklenir ve tasarımcı, sayfanın kullanıcı denetimini tanıması için gereken @ Register yönergesini oluşturur. Artık denetimin genel özellikleri ve yöntemleriyle çalışabilirsiniz.

Web Bölümüne kullanıcı denetimi eklemek için, kullanıcı denetimini Web Bölümü kod dosyasındaki Web Bölümü Controls koleksiyonuna ekleyin. Aşağıdaki örnek, Web Bölümü koleksiyonuna Controls bir kullanıcı denetimi ekler.

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

<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

Kullanıcı denetiminde hata ayıklama

Kullanıcı denetiminde hata ayıklamak için, kullanıcı denetiminin SharePoint projenizdeki bir uygulama sayfasına veya Web Bölümüne eklendiğinden emin olun. Daha sonra, herhangi bir Visual Studio Projesindeki kod hatalarını ayıkladığınız gibi kullanıcı denetiminde de kod hatalarını ayıklayabilirsiniz.

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

SharePoint'te, kullanıcı denetimini içeren uygulama sayfasını açın. Kullanıcı denetimi bir Web Bölümüne eklenmişse, Web Bölümünü SharePoint'teki bir Web Bölümü sayfasına ekleyin.

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

İlgili konular