Aracılığıyla paylaş

Değiştirilebilir parametreler

Gerçek değerleri tasarım zamanında bilinmeyen SharePoint çözüm öğeleri için değerler sağlamak üzere proje dosyalarının içinde değiştirilebilir parametreler veya belirteçler kullanılabilir. İşlev olarak standart Visual Studio şablon belirteçlerine benzerler. Daha fazla bilgi için bkz . Şablon Parametreleri.

Belirteç biçimi

Belirteçler bir dolar işareti ($) karakteriyle başlar ve biter. Dağıtımda, bir proje bir SharePoint çözüm paketine (.wsp dosyası) paketlendiğinde kullanılan belirteçler gerçek değerlerle değiştirilir. Örneğin, $SharePoint.Package.Name$ belirteci "SharePoint Paketini Test Et" dizesine çözümlenebilir.

Belirteç kuralları

Belirteçler için aşağıdaki kurallar geçerlidir:

  • Belirteçler bir satırda herhangi bir yerde belirtilebilir.

  • Belirteçler birden çok satıra yayılamaz.

  • Aynı belirteç aynı satırda ve aynı dosyada birden çok kez belirtilebilir.

  • Aynı satırda farklı belirteçler belirtilebilir.

    Bu kurallara uymayan belirteçler yoksayılır ve uyarı veya hataya neden olmaz.

    Belirteçlerin dize değerlerine göre değiştirilmesi bildirim dönüştürme işleminden hemen sonra gerçekleştirilir. Bu değiştirme, kullanıcının bildirim şablonlarını belirteçlerle düzenlemesine olanak tanır.

Belirteç adı çözümlemesi

Çoğu durumda belirteç, nerede bulunduğundan bağımsız olarak belirli bir değere çözümleniyor. Bununla birlikte, belirteç bir paket veya özellikle ilgiliyse, belirtecin değeri nerede bulunduğuna bağlıdır. Örneğin, bir özellik A Paketi'ndeyse belirteç $SharePoint.Package.Name$ "A Paketi" değerine çözümleniyor demektir. Aynı özellik B Paketi'ndeyse , $SharePoint.Package.Name$ "B Paketi" olarak çözümleniyor demektir.

Belirteçler listesi

Aşağıdaki tabloda kullanılabilir belirteçler listelenir.

Veri Akışı Adı Açıklama
$SharePoint.Project.FileName$ NewProj.csproj gibi , içeren proje dosyasının adı.
$SharePoint.Project.FileNameWithoutExtension$ Dosya adı uzantısı olmayan içeren proje dosyasının adı. Örneğin, "NewProj".
$SharePoint.Project.AssemblyFullName$ Projenin çıkış derlemesini içeren görünen adı (tanımlayıcı ad).
$SharePoint.Project.AssemblyFileName$ Projenin çıkış derlemesini içeren adı.
$SharePoint.Project.AssemblyFileNameWithoutExtension$ Dosya adı uzantısı olmadan projenin çıkış derlemesini içeren adı.
$SharePoint.Project.AssemblyPublicKeyToken$ Projenin çıkış derlemesini içeren ortak anahtar belirteci bir dizeye dönüştürülür. ("x2" onaltılık biçimde 16 karakter.)
$SharePoint.Package.Name$ İçeren paketin adı.
$SharePoint.Package.FileName$ İçeren paketin tanım dosyasının adı.
$SharePoint.Package.FileNameWithoutExtension$ İçeren paketin tanım dosyasının adı (uzantı olmadan).
$SharePoint.Package.Id$ İçeren paketin SharePoint Kimliği. Bir özellik birden fazla pakette kullanılıyorsa, bu değer değişir.
$SharePoint.Feature.FileName$ Özellik1.feature gibi içeren özelliğin tanım dosyasının adı.
$SharePoint.Feature.FileNameWithoutExtension$ Dosya adı uzantısı olmadan özellik tanımı dosyasının adı.
$SharePoint.Feature.DeploymentPath$ Paketteki özelliği içeren klasörün adı. Bu belirteç, Özellik Tasarım Aracı "Dağıtım Yolu" özelliğine eşit olur. Örnek değer: "Project1_Feature1".
$SharePoint.Feature.Id$ İçeren özelliğin SharePoint Kimliği. Bu belirteç, tüm özellik düzeyi belirteçlerde olduğu gibi, yalnızca bir özellik aracılığıyla pakete dahil edilen dosyalar tarafından kullanılabilir, özelliğin dışındaki bir pakete doğrudan eklenemez.
$SharePoint.ProjectItem.Name$ ISharePointProjectItem.Name elde edilen proje öğesinin adı (dosya adı değil).
$SharePoint.Type.<GUID>. AssemblyQualifiedName$ Belirtecin GUID değeriyle eşleşen türün derleme tam adı. GUID'nin biçimi küçük harftir ve Guid.ToString("D") biçimine (xxxxx-xxxx-xxxx-xxxx-xxxx) karşılık gelir.
$SharePoint.Type.<GUID>. FullName$ Belirteçteki GUID ile eşleşen türün tam adı. GUID'nin biçimi küçük harftir ve Guid.ToString("D") biçimine (xxxxx-xxxx-xxxx-xxxx-xxxx) karşılık gelir.

Belirteç değiştirme dosya uzantıları listesine uzantı ekleme

Belirteçler teorik olarak pakette yer alan bir SharePoint proje öğesine ait herhangi bir dosya tarafından kullanılabilse de, Visual Studio varsayılan olarak yalnızca paket dosyalarında, bildirim dosyalarında ve aşağıdaki uzantılara sahip dosyalarda belirteçleri arar:

  • XML

  • ASCX

  • ASPX

  • Webpart

  • DWP

    Bu uzantılar, ...\program files>\MSBuild\Microsoft\<VisualStudio\v11.0\SharePointTools klasöründe bulunan Microsoft.VisualStudio.SharePoint.targets dosyasındaki öğesi tarafından <TokenReplacementFileExtensions> tanımlanır.

    Ancak, listeye ek dosya uzantıları ekleyebilirsiniz. SharePoint hedef dosyasının İçeri Aktarılmasından> önce <tanımlanan SharePoint proje dosyasındaki herhangi bir PropertyGroup öğesine bir <TokenReplacementFileExtensions> öğe ekleyin.

Not

Belirteç değiştirme işlemi bir proje derlendiğinden, .cs, .vb veya .resx gibi derlenmiş dosya türleri için dosya uzantıları eklememelisiniz. Belirteçler yalnızca derlenmemiş dosyalarda değiştirilir.

Örneğin, belirteç değiştirme dosya adı uzantıları listesine dosya adı uzantılarını (.myextension ve .yourextension) eklemek için aşağıdakileri bir proje (.csproj) dosyasına eklersiniz:

<Project ToolsVersion="4.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
.
.
.
    <!-- Define the following property to add your extension to the list of token replacement file extensions.  -->
<TokenReplacementFileExtensions>myextension;yourextension</TokenReplacementFileExtensions>
</PropertyGroup>

Uzantıyı doğrudan hedefler (.targets) dosyasına ekleyebilirsiniz. Ancak uzantının eklenmesi, yerel sistemde paketlenmiş tüm SharePoint projeleri için uzantı listesini değiştirir, yalnızca sizin değil. Bu uzantı, sistemdeki tek geliştirici olduğunuzda veya projelerinizin çoğu bunu gerektiriyorsa kullanışlı olabilir. Ancak, sisteme özgü olduğundan, bu yaklaşım taşınabilir değildir ve bu nedenle, bunun yerine proje dosyasına herhangi bir uzantı eklemeniz önerilir.

İlgili içerik