Proje öğelerinde paketleme ve dağıtım bilgilerini sağlama
Visual Studio'daki tüm SharePoint proje öğeleri, proje SharePoint'e dağıtıldığında ek veri sağlamak için kullanabileceğiniz özelliklere sahiptir. Bu özellikler aşağıdaki gibidir:
Özellik Özellikleri
Özellik Alıcıları
Proje Çıkış Başvuruları
Denetim Girdilerini Kasa
Bu özellikler Özellikler penceresinde görünür.
Özellik özellikleri
Özelliğin kullandığı verileri belirtmek için Özellik Özellikleri özelliğini kullanın. Özellik özellikleri verileri, SharePoint'e dağıtılırken bir özelliğe dahil edilen bir değer kümesidir (anahtar/değer çiftleri olarak depolanır). Özellik dağıtıldıktan sonra kodunuzda özellik değerlerine erişebilirsiniz.
Bir proje öğesine özellik özelliği değeri eklediğinizde, değer öğenin özelliği bildiriminde bir öğe olarak eklenir. bir İş Verileri Bağlan ivity (İVB) model projesinde, örneğin, ModelFileName özellik özelliği şu şekilde görünür:
<Property Key="ModelFileName" Value="BdcModel1\BdcModel1.bdcm" />
Özellik Özelliği değerini ayarladıktan sonra, projenin .spdata dosyasına FeatureProperty öğesi olarak eklenir. SharePoint'teki özelliklere erişme hakkında bilgi için bkz . SPFeaturePropertyCollection Sınıfı.
Tüm proje öğelerindeki aynı özellik özellik değerleri özellik bildiriminde birleştirilir. Ancak, iki farklı proje öğesi aynı özellik özellik anahtarını eşleşmeyen değerlerle belirtirse bir doğrulama hatası oluşur.
Özellik özelliklerini doğrudan özellik dosyasına (.feature) eklemek için Visual Studio SharePoint nesne modeli yöntemini çağırın Add. Bu yöntemi kullanırsanız, Özellik Özellikleri'nde aynı özellik özellik değerlerini eklemeyle ilgili aynı kuralın doğrudan özellik dosyasına eklenen özellikler için de geçerli olduğunu unutmayın.
Özellik alıcısı
Özellik alıcıları, bir proje öğesinin içeren özelliğinde belirli olaylar gerçekleştiğinde yürütülen kodlardır. Örneğin, özellik yüklendiğinde, etkinleştirildiğinde veya yükseltildiğinde yürütülen özellik alıcıları tanımlayabilirsiniz. Özellik alıcısı eklemenin bir yolu, bunu İzlenecek Yol: Özellik olay alıcıları ekleme başlığı altında açıklandığı gibi doğrudan bir özelliğe eklemektir. Bir diğer yol da Özellik Alıcısı özelliğinde özellik alıcısı sınıf adına ve derlemesine başvurmaktır.
Doğrudan yöntem
Bir özelliğe doğrudan özellik alıcısı eklediğinizde, Çözüm Gezgini'daki Özellik düğümü altına bir kod dosyası yerleştirilir. SharePoint çözümünüzü oluşturduğunuzda kod bir derlemede derlenip SharePoint'e dağıtılır. Varsayılan olarak, Alıcı Derlemesi ve Alıcı Sınıfı özellik özellikleri sınıf adına ve derlemesine başvurur.
Reference yöntemi
Özellik alıcısı eklemenin bir diğer yolu da, özellik alıcı derlemesine başvurmak için bir proje öğesinin Özellik Alıcısı özelliğini kullanmaktır. Özellik Alıcısı özellik değerinin iki alt özelliği vardır: Derleme ve Sınıf Adı. Derlemenin tam olarak nitelenmiş "strong" adını kullanması ve sınıf adının tam tür adı olması gerekir. Daha fazla bilgi için bkz . Tanımlayıcı Adlandırılmış Derlemeler. Çözüm SharePoint'e dağıtıldıktan sonra özellik, özellik olaylarını işlemek için başvuruda bulunan özellik alıcısını kullanır.
Çözüm derleme zamanında, özellik ve projelerindeki özellik alıcısı özellik değerleri, SharePoint çözümü (.wsp) dosyasının özellik bildiriminde Feature öğesinin ReceiverAssembly ve ReceiverClass özniteliklerini ayarlamak için birleştirilir. Bu nedenle, bir proje öğesinin ve özelliğin Derleme ve Sınıf Adı özellik değerleri belirtilirse, proje öğesi ve özellik özellik değerleri eşleşmelidir. Değerler eşleşmiyorsa doğrulama hatası alırsınız. Bir proje öğesinin, özelliğinin kullandığından farklı bir özellik alıcı derlemesine başvurmasını istiyorsanız, bunu başka bir özelliğe taşıyın.
Henüz sunucuda olmayan bir özellik alıcı derlemesine başvuruyorsanız, derleme dosyasının kendisini de pakete eklemeniz gerekir; Visual Studio sizin için eklemez. Özelliği dağıttığınızda, derleme dosyası sistemin genel derleme önbelleğine (GAC) veya SharePoint fiziksel dizinindeki Bin klasörüne kopyalanır. Daha fazla bilgi için bkz. nasıl yapılır: Nasıl yapılır: Ek derlemeler ekleme ve kaldırma.
Özellik alıcıları hakkında daha fazla bilgi için bkz . Özellik Olay Alıcısı ve Özellik Olayları.
Proje çıkış başvuruları
Project Output References özelliği, proje öğenizin çalıştırılması gereken bir derleme gibi bir bağımlılığı belirtir. Örneğin, çözümünüzün bir İVB projesi ve bir sınıf projesi olduğunu varsayalım. İVB projesinin sınıf projesi tarafından çıktısı alınan derlemeye bağımlılığı varsa, İVB projesinin Project Output References özelliğinde derlemeye başvurabilirsiniz. İVB projesi paketlendiğinde, bağımlı derleme pakete eklenir.
Proje çıkış başvuruları genellikle derlemelerdir, ancak bazı durumlarda (Silverlight projeleri gibi) diğer dosya türleri olabilir.
Daha fazla bilgi için bkz . Nasıl yapılır: Proje çıkış başvurusu ekleme.
denetim girdilerini Kasa
SharePoint, güvenilmeyen kullanıcıların erişimini belirli denetimlerle sınırlamak için güvenli denetim girdileri olarak adlandırılan bir güvenlik mekanizması sağlar. Tasarım gereği, SharePoint güvenilmeyen kullanıcıların SharePoint sunucusunda ASPX sayfalarını karşıya yüklemesine ve oluşturmasına olanak tanır. Bu kullanıcıların ASPX sayfalarına güvenli olmayan kod eklemesini önlemek için SharePoint, güvenli denetimlere erişimini sınırlar. Kasa denetimleri, güvenli olarak belirlenen ve sitenizdeki herhangi bir kullanıcı tarafından kullanılabilen ASPX denetimleri ve Web bölümleridir. Daha fazla bilgi için bkz. 4. Adım: Web Bölümünüzü Kasa Denetimler Listesine ekleme.
Visual Studio'daki her SharePoint proje öğesinin iki Boole alt özelliğine sahip Kasa Denetim Girdileri adlı bir özelliği vardır: Kasa ve Betikte Kasa. Kasa özelliği, güvenilmeyen kullanıcıların bir denetime erişip erişemeyeceğini belirtir. betikte Kasa özelliği, güvenilmeyen kullanıcıların denetimin özelliklerini görüntüleyip görüntüleyemeyeceğini ve değiştirebileceğini belirtir.
Kasa denetim girişlerine derleme temelinde başvurulur. Proje öğesinin Kasa Denetim Girişleri özelliğine girerek projenin derlemesine güvenli denetim girdileri eklersiniz. Bununla birlikte, pakete ek bir derleme eklediğinizde Paket Tasarım Aracı Gelişmiş sekmesinden projenin derlemesine güvenli denetim girdileri de ekleyebilirsiniz. Daha fazla bilgi için bkz. Nasıl yapılır: Denetimleri güvenli denetim olarak işaretleme veya Web Bölümü Derlemesini Kasa Denetimi Olarak Kaydetme.
Güvenli denetimler için XML girişleri
Bir proje öğesine veya projenin derlemesine güvenli denetim girişi eklediğinizde, paket bildirimine aşağıdaki biçimde bir başvuru yazılır:
<Assemblies>
<Assembly Location="<assembly name>.dll"
DeploymentTarget="<'GlobalAssemblyCache' or 'WebApplication'">>
<SafeControls>
<SafeControl Assembly="<assembly name>.dll" Namespace=
"<SharePoint project name>" Safe="<true/false>"
TypeName="<control name>"
SafeAgainstScript="<true/false>" />
</SafeControls>
</Assembly>
</Assemblies>