Aracılığıyla paylaş

SharePoint için web bölümleri oluşturma

  • Makale

Web bölümlerini kullanarak, tarayıcı kullanarak SharePoint sitesinin sayfalarının içeriğini, görünümünü ve davranışını değiştirebilirsiniz. Web bölümleri, bir web bölümü sayfasının içinde çalışan sunucu tarafı denetimleridir: SharePoint sitesinde görünen sayfaların yapı taşlarıdır. Bkz. Yapı Taşı: Web Bölümleri.

Visual Studio'dan şablonları kullanarak SharePoint sitesinde web bölümleri oluşturabilir ve hatalarını ayıklayabilirsiniz.

Visual Studio'da web bölümü oluşturma

Herhangi bir SharePoint projesine Web Bölümü öğesi ekleyerek bir web bölümü oluşturun. Korumalı bir çözümde veya grup çözümünde Web Bölümü öğesi kullanabilirsiniz.

Bir web bölümünü tasarımcı kullanarak görsel olarak tasarlamak istiyorsanız, bir Visual Web Bölümü projesi oluşturun veya herhangi bir SharePoint projesine Visual Web Bölümü öğesi ekleyin. Bir Visual Web Bölümü öğesini yalnızca bir grup çözümünde kullanabilirsiniz.

Web bölümü öğesi

Web Bölümü öğesi, SharePoint sitesi için web bölümü tasarlamak için kullanabileceğiniz dosyalar sağlar. Bir Web Bölümü öğ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.

Dosya Açıklama
Elements.xml Projenizdeki Özellik tanımı dosyasının web bölümünü dağıtmak için kullandığı bilgileri içerir.
.webpart dosyası SharePoint'in web bölümünüzü bir web bölümü galerisinde görüntülemesi için gereken bilgileri sağlar.
Kod Dosyası Web bölümüne denetim ekleyen ve web bölümünde özel içerik oluşturan yöntemleri içerir.

Daha fazla bilgi için bkz . Nasıl yapılır: SharePoint web bölümü oluşturma.

Görsel web bölümü öğesi

Görsel web bölümü, Visual Studio'da Visual Web Geliştirici tasarımcısını kullanarak oluşturduğunuz bir web bölümüdür. Görsel web bölümü, diğer web bölümleriyle aynı şekilde çalışır. Web bölümüne düğmeler ve metin kutuları gibi denetimler eklemek için XML dosyasına kod eklersiniz. Ancak, visual Studio Araç Kutusu'ndan denetimleri web bölümüne sürükleyerek veya kopyalayarak görsel web bölümüne ekleyebilirsiniz. Tasarımcı daha sonra XML dosyasında gerekli kodu oluşturur. Bkz . Nasıl yapılır: Tasarımcı kullanarak SharePoint web bölümü oluşturma.

SharePoint denetimleri

Visual Studio, Uygulama sayfaları gibi SharePoint sayfaları oluşturmak için bazı denetimler sağlar. Bu denetimler Araç Kutusu'nda SharePoint Denetimleri'nin altında görünür. Bu denetimlerin işlevselliği, SharePoint sitesinde ve liste sayfalarında kullanılan ASP.NET sunucu denetimlerini içeren Microsoft.SharePoint.WebControls ad alanından türetilir.

Denetim Adı Açıklama
AspMenu ASP menüsü ekler. Daha fazla bilgi için bkz . Menü Denetimine Genel Bakış.
CssLink .aspx sayfasına bir LINK öğesi ekler ve CssRegistration tarafından tanımlanan bir veya daha fazla dış stil sayfası uygular.
Datetimecontrol .aspx sayfasına bir DateTime denetimi ekler.
FormDigest .aspx sayfasına güvenlik doğrulaması ekler
ListProperty Belirtilen listenin bir özelliğini döndürür.
ProjectProperty Geçerli web sitesinin genel özelliğini döndürür.
RssLink .aspx sayfasına BIR RSS akışına bağlantı ekler.
ScriptLink Sayfa işlenirken istenebilmeleri için bir sayfaya betikler gibi kaynakları kaydetmek için özellikler ve yöntemler sağlar.
Tema .aspx sayfasına bir tema uygular.

Web bölümünde hata ayıklama

Web bölümü içeren bir SharePoint projesinde, diğer Visual Studio projelerinde olduğu gibi hata ayıklayabilirsiniz. Visual Studio hata ayıklayıcısını başlattığınızda, Visual Studio SharePoint sitesini açar.

Kodunuzun hatalarını ayıklamaya başlamak için 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.

Görsel web bölümü sınırlamaları

Visual Studio'dan başlayarak korumalı SharePoint çözümlerine ve grup çözümlerine görsel web bölümleri ekleyebilirsiniz. Ancak görsel web bölümlerinin sınırlamaları şunlardır:

  • Görsel web bölümleri Değiştirilebilir parametreleri desteklemez. Daha fazla bilgi için bkz . Değiştirilebilir parametreler.

  • Kullanıcı denetimleri veya görsel web bölümleri sürüklenemez ve bırakılamaz veya görsel web bölümlerine kopyalanamaz. Bu eylem bir derleme hatasına neden olur.

  • Görsel web bölümleri, $SPUrl gibi SharePoint sunucu belirteçlerini doğrudan desteklemez. Daha fazla bilgi için SharePoint çözümleriyle ilgili sorunları giderme konusunun "Korumalı Görsel Web Bölümleri Belirteç Kısıtlamaları" konusuna bakın.

  • Korumalı bir çözümdeki görsel web bölümleri bazen "Korumalı Kod Ana Bilgisayar Hizmeti isteği işleyemeyecek kadar meşgul olduğundan korumalı kod yürütme isteği reddedildi" hatasını alır. Bu hata hakkında daha fazla bilgi için SharePoint Geliştirici Ekibi Blogu'ndaki bu gönderiye bakın.

  • Visual Studio'da sunucu tarafı JavaScript hata ayıklaması desteklenmez, ancak istemci tarafı JavaScript hata ayıklaması desteklenir.

    Sunucu tarafı işaretleme dosyasına satır içi JavaScript ekleyebilmenize rağmen, işaretlemeye eklenen kesme noktaları için hata ayıklama desteklenmez. JavaScript'te hata ayıklamak için, işaretleme dosyasındaki bir dış JavaScript dosyasına başvurun ve ardından JavaScript dosyasındaki kesme noktalarını ayarlayın.

  • Satır içi ASP.NET kodunda hata ayıklama, işaretleme dosyası yerine oluşturulan kod dosyasında yapılmalıdır.

  • Görsel web bölümleri yönergesinin <@ Assembly Src= kullanımını desteklemez.

  • SharePoint web denetimleri ve bazı ASP.NET denetimleri SharePoint korumalı ortamında desteklenmez. Korumalı bir çözümde görsel web bölümünde desteklenmeyen denetimler kullanılıyorsa, "'Tema' türü veya ad alanı adı 'Microsoft.SharePoint.WebControls' ad alanında yok" hatası görüntülenir.

    Korumalı çözümler hakkında daha fazla bilgi için bkz . Korumalı alan ve grup çözümleri arasındaki farklar.

Daha eski stil SharePoint tabanlı web bölümleri oluşturma

Visual Studio'daki şablonları kullanarak SharePoint için özel ASP.NET 2.0 web bölümleri oluşturabilirsiniz. ASP.NET 2.0 web bölümleri, ASP.NET web bölümü altyapısının üzerine kurulmuştur ve yeni projeler için önerilen türdür.

Çok az durumda, daha eski stildeki SharePoint tabanlı web bölümünü kullanarak bir web bölümü oluşturmanız gerekebilir. Bu tür web bölümleri oluşturmak için Visual Studio'yu kullanabilirsiniz, ancak Visual Studio bunları oluşturmanıza yardımcı olmak için özel olarak tasarlanmış hiçbir şablon sağlamaz.

Daha eski bir Stil SharePoint tabanlı web bölümü oluşturmak isteyebileceğiniz zamanlar hakkında daha fazla bilgi için bkz . Windows SharePoint Hizmetleri'nde Web Bölümü Altyapısı. Daha eski stildeki SharePoint tabanlı web bölümünü kullanarak web bölümü oluşturma hakkında daha fazla bilgi için bkz . Temel SharePoint Web Bölümü Oluşturma kılavuzu.

Ünvan Açıklama
Nasıl yapılır: SharePoint web bölümü oluşturma SharePoint sayfaları için web bölümlerinin nasıl oluşturulacağını gösterir.
Nasıl yapılır: Tasarımcı kullanarak SharePoint web bölümü oluşturma Görsel tasarım yüzeyi kullanarak SharePoint için web bölümleri oluşturmayı gösterir.
Nasıl yapılır: SharePoint uygulama sayfası veya web bölümü için kullanıcı denetimi oluşturma SharePoint'te çalışan uygulama sayfaları ve web bölümleri tarafından kullanılabilecek özel, yeniden kullanılabilir denetimlerin nasıl oluşturulacağını gösterir.
İzlenecek yol: SharePoint için web bölümü oluşturma SharePoint için web bölümü tasarlamayı açıklar.
İzlenecek yol: Tasarımcı kullanarak SharePoint için web bölümü oluşturma Denetimleri görsel tasarım yüzeyine sürükleyerek SharePoint için web bölümü tasarlamayı açıklar.
İzlenecek yol: SharePoint için OData görüntüleyen Silverlight web bölümü oluşturma Bir Silverlight uygulamasını barındıran ve SharePoint listelerindeki verileri görüntüleyen SharePoint için bir web bölümünün nasıl tasarlandığını açıklar.