Nahraditelné parametry
Nahraditelné parametry nebo tokeny, uvnitř souborů projektu lze uvést hodnoty pro položky řešení SharePoint, jehož skutečné hodnoty nejsou známy v době návrhu.Jsou podobné funkce standardní Visual Studio šablona tokeny. 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é hodnoty při projektu při nasazení zabaleno do souboru balíčku (WSP) řešení SharePoint.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 kdekoliv 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 ve stejném souboru.
Může být zadán jiný tokeny na stejném řádku.
Tokeny, které není postupujte podle těchto pravidel jsou ignorována bez poskytnutí upozornění nebo chyba.
Nahrazení tokeny řetězec hodnoty se provádí ihned po manifestu transformace, takže manifestu šablony upravit uživatel, který chcete použít tokeny.
.gif "Ee231545.collapse_all(cs-cz,VS.110).gif")
Překlad token
Ve většině případů token řeší konkrétní hodnotu, bez ohledu na to, kde je obsažena.Však pokud token souvisí balíčku nebo funkce, tokenu hodnota závisí na kterém je obsažen.Například pokud je funkce balíček potom token $SharePoint.Package.Name$ řeší hodnotu "Balíček A." Pokud stejné funkce je v balíčku B pak $SharePoint.Package.Name$ řeší "Balíčku B."
Seznam tokenů
Následující tabulka uvádí dostupné tokeny.
Název |
Description |
|---|---|
$SharePoint.Project.filename$ |
Název obsahující soubor projektu, například "NewProj.csproj". |
$SharePoint.Project.FileNameWithoutExtension$ |
Název obsahující soubor projektu bez přípony názvu souboru.Například "NewProj". |
$SharePoint.Project.AssemblyFullName$ |
Zobrazovaný název (silný název) obsahující projekt společnosti výstupu sestavení. |
$SharePoint.Project.AssemblyFileName$ |
Název projektu obsahující jeho výstupu sestavení. |
$SharePoint.Project.AssemblyFileNameWithoutExtension$ |
Název projektu obsahující jeho výstupu sestavení bez přípony názvu souboru. |
$SharePoint.Project.AssemblyPublicKeyToken$ |
Token veřejného klíče pro projekt obsahující jeho výstupu sestavení převedena na řetězec.(16 znaků v "x 2" šestnáctkovém formátu.) |
$SharePoint.Package.Name$ |
Název balíčku. |
$SharePoint.Package.filename$ |
Název definičního souboru balíčku obsahuje. |
$SharePoint.Package.FileNameWithoutExtension$ |
Název definičního souboru balíčku obsahujícího (bez přípony). |
$SharePoint.Package.ID$ |
ID služby SharePoint obsahující balíček.Pokud funkce se používá více než jeden balíček, bude tuto hodnotu změnit. |
$SharePoint.Feature.filename$ |
Název definičního souboru obsahujícího funkci, například Feature1.feature. |
$SharePoint.Feature.FileNameWithoutExtension$ |
Název funkce definiční soubor bez přípony názvu souboru. |
$SharePoint.Feature.DeploymentPath$ |
Název složky, která obsahuje funkci v balíčku.Tento token se rovná "Cesta nasazení" vlastnosti v Návrháři funkce.Ukázková hodnota je "Project1_Feature1". |
$SharePoint.Feature.ID$ |
ID služby SharePoint obsahující funkci.Tento token jako všechny funkce úrovně tokeny lze používat pouze soubory, které jsou součástí 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$ |
Kvalifikovaný název sestavení odpovídající typ 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). |
Přidání rozšíření tokenu náhradní soubor rozšíření seznamu
Přestože tokeny lze teoreticky souborem, který patří do projektu SharePoint položky součástí balíčku, ve výchozím Visual Studio hledá tokeny pouze v balíčku souborů manifestu a soubory s následujícími příponami:
XML
ASCX
ASPX
WebPart
DWP
Tato rozšíření jsou definovány <TokenReplacementFileExtensions> elementu v souboru Microsoft.VisualStudio.SharePoint.targets umístěn v... \ < program files > \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 PropertyGroup, všechny v souboru projektu služby SharePoint, který je definován před <Import> cíle souboru 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.
Přidat do seznamu přípon tokenu náhradní soubor název rozšíření ".myextension" a ".yourextension", například by přidat následující soubor .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>
Rozšíření můžete také přidat přímo do souboru TARGETS.Tím však změní seznam rozšíření pro všechny projekty SharePoint zabaleny v místním systému nejen vlastní.To může být vhodné jsou jediným vývojáře v systému, nebo pokud to vyžadují většinu projektů.Však protože je specifické pro systém, tento přístup je velmi přenosný a proto je vhodné přidat všechny přípony souboru projektu místo.