Nahraditelné parametry
Nahraditelné parametry, nebo tokenů, lze použít uvnitř souborů projektu poskytnout hodnoty pro položky řešení služby SharePoint, jejichž skutečné hodnoty nejsou známy v době návrhu.Jsou podobně jako u standardního Visual Studio šablona tokenů.Další informace naleznete v tématu Parametry šablony.
Formát tokenu
Tokeny začínají a končí znakem dolaru ($).Všechny tokeny používané jsou nahrazeny skutečnými hodnotami při projektu je zabalen do souboru balíčku (WSP) řešení služby SharePoint v okamžiku nasazení.Například token $SharePoint.Package.Name$ může vyřešit řetězec "Test SharePoint balíček.
Token pravidla
Následující pravidla se vztahují na tokeny:
Tokeny lze zadat libovolné místo v řádku.
Tokenů nemůže zahrnovat více řádků.
Stejný token může být zadán více než jednou na stejném řádku a v jednom souboru.
Různé tokeny lze zadat na stejném řádku.
Tokeny, které nebudete postupovat podle těchto pravidel jsou ignorovány bez poskytnutí upozornění nebo chyba.
Nahrazení tokenů podle hodnoty řetězce se provádí ihned po manifestu transformace, takže manifestu šablony upraven uživatelem, který chcete použít tokeny.
Název tokenu rozlišení
Ve většině případů řeší token na určitou hodnotu, bez ohledu na to, kde je obsažena.Pokud token je spojena s balíčku nebo funkce, je token hodnota však závisí na kde je obsažen.Například pokud je funkce v balíčku token pak $SharePoint.Package.Name$ se překládá na hodnotu "Balíček A." Pokud stejné je v balíčku B, pak $SharePoint.Package.Name$ řeší "Balíčku b."
Seznam tokenů
V následující tabulce jsou uvedeny dostupné tokeny.
Název |
Description |
|---|---|
$SharePoint.Project.FileName$ |
Název obsahující soubor projektu, jako například "NewProj.csproj". |
$SharePoint.Project.FileNameWithoutExtension$ |
Název souboru obsahující projekt bez přípony názvu souboru.Například "NewProj". |
$SharePoint.Project.AssemblyFullName$ |
Výstup sestavení projektu obsahující zobrazovaný název (silný název). |
$SharePoint.Project.AssemblyFileName$ |
Název projektu obsahuje výstup sestavení. |
$SharePoint.Project.AssemblyFileNameWithoutExtension$ |
Název projektu obsahuje výstup sestavení bez přípony názvu souboru. |
$SharePoint.Project.AssemblyPublicKeyToken$ |
Výstup projektu obsahující token veřejného klíče sestavení, která je převedena na řetězec. (16 znaků v "x 2" hexadecimální formát.) |
$SharePoint.Package.Name$ |
Název obsahující balíček. |
$SharePoint.Package.FileName$ |
Název definičního souboru balíčku, který obsahuje. |
$SharePoint.Package.FileNameWithoutExtension$ |
Název balíček obsahující definičního souboru (bez přípony). |
$SharePoint.Package.Id$ |
ID serveru SharePoint obsahující balíček.Funkce se používá více než jeden balíček, bude změna této hodnoty. |
$SharePoint.Feature.FileName$ |
Název definičního souboru, který obsahuje funkce, jako je například Feature1.feature. |
$SharePoint.Feature.FileNameWithoutExtension$ |
Název souboru bez přípony názvu souboru definice funkce. |
$SharePoint.Feature.DeploymentPath$ |
Název složky, která obsahuje funkci v balíčku.Tento token je "Cesta nasazení" vlastnost v Návrháři funkce.Jako příklad hodnota je "Project1_Feature1". |
$SharePoint.Feature.Id$ |
ID serveru SharePoint obsahující funkci.Tento token tokeny jsou všechny funkce na úrovni, můžete využít pouze soubory obsažené v balíčku prostřednictvím funkce, nelze přidat přímo do balíčku mimo funkci. |
$SharePoint.ProjectItem.Name$ |
Název položky projektu (nikoli jeho název souboru), jako získané z ISharePointProjectItem.Name. |
$SharePoint.Type.<GUID>.AssemblyQualifiedName$ |
Sestavení kvalifikovaný název typu párování GUID tokenu.Formát GUID je malá a odpovídá formátu Guid.ToString("D") (který je xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). |
$SharePoint.Type.<GUID>.FullName$ |
Úplný název typu odpovídající identifikátor GUID v tokenu.Formát identifikátoru GUID je malá a odpovídá formátu Guid.ToString("D") (který je xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). |
Seznam přípon souborů přidáním rozšíření pro nahrazení tokenu
Tokeny lze teoreticky souborem, který patří do projektu SharePoint položky součástí balíčku, ve výchozím nastavení, ale Visual Studio hledá tokenů pouze soubory balíčku manifest soubory a soubory s následujícími příponami:
XML
ASCX
ASPX
Webová část
DWP
Tato rozšíření jsou definovány <TokenReplacementFileExtensions> element v souboru Microsoft.VisualStudio.SharePoint.targets umístěn v... \<soubory programů>\MSBuild\Microsoft\VisualStudio\v11.0\SharePointTools složky.
Můžete však přidat další rozšíření souboru do seznamu.Chcete-li to provést, přidejte <TokenReplacementFileExtensions> element k jakékoli PropertyGroup v souboru projektu služby SharePoint, který je definován před <Import> souboru cílů služby SharePoint.
[!POZNÁMKA]
Po kompilaci projektu dojde k nahrazení tokenu, a proto byste neměli přidávat přípony typů souborů, které jsou kompilovány, například .cs, .vb nebo .resx.Tokeny jsou nahrazeny pouze v souborech, které nejsou kompilovány.
Chcete-li přidat do seznamu přípon názvů souborů v tokenu náhradní soubor název rozšíření ".myextension" a ".yourextension", například by přidejte následující do souboru .csproj:
<Project ToolsVersion="4.0" DefaultTargets="Build" xmlns="https://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>
Alternativně můžete přidat rozšíření přímo k souboru TARGETS.Tím však změní seznam přípon pro všechny projekty SharePoint zabalen v místním systému, nikoli pouze své vlastní.To může být vhodné po jediný developer v systému, nebo pokud to vyžadují většinu vašich projektů.Však protože je specifické pro systém, tento přístup není úplně přenosný a proto je vhodné přidat libovolné rozšíření souboru projektu místo.