Ersättningsbara parametrar

Ersättningsbara parametrar, eller token, kan användas i projektfiler för att ange värden för SharePoint-lösningsobjekt vars faktiska värden inte är kända vid designtillfället. De liknar standardtoken för Visual Studio-mallar i funktion. Mer information finns i Mallparametrar.

Tokenformat

Token börjar och slutar med ett dollartecken ($). Vid distribution ersätts alla token som används med faktiska värden när ett projekt paketeras i ett SharePoint-lösningspaket (.wsp-fil ). Token $SharePoint.Package.Name$ kan till exempel matcha till strängen "Test SharePoint Package".

Tokenregler

Följande regler gäller för token:

• Token kan anges var som helst på en rad.

• Token kan inte sträcka sig över flera rader.

• Samma token kan anges mer än en gång på samma rad och i samma fil.

• Olika token kan anges på samma rad.

  Token som inte följer dessa regler ignoreras och resulterar inte i en varning eller ett fel.

  Bytet av token med strängvärden görs omedelbart efter manifesttransformeringen. Med den här ersättningen kan användaren redigera manifestmallarna med token.

Upplösning av tokennamn

I de flesta fall matchas en token till ett specifikt värde oavsett var den finns. Men om token är relaterad till ett paket eller en funktion beror tokens värde på var den finns. Om en funktion till exempel finns i Paket A matchas token $SharePoint.Package.Name$ till värdet "Paket A". Om samma funktion finns i paket B matchas $SharePoint.Package.Name$ till "Paket B".

Lista över token

I följande tabell visas tillgängliga token.

Lägga till tillägg i listan med filnamnstillägg för tokenbyte

Även om token teoretiskt sett kan användas av alla filer som tillhör ett SharePoint-projektobjekt som ingår i paketet, söker Visual Studio som standard endast efter token i paketfiler, manifestfiler och filer som har följande tillägg:

• XML

• ASCX

• ASPX

• Webbkomponent

• DWP

  Dessa tillägg definieras av elementet <TokenReplacementFileExtensions> i filen Microsoft.VisualStudio.SharePoint.targets, som finns i mappen ...\<program files>\MSBuild\Microsoft\VisualStudio\v11.0\SharePointTools.

  Du kan dock lägga till ytterligare filnamnstillägg i listan. Lägg till ett <TokenReplacementFileExtensions> element i valfri PropertyGroup i SharePoint-projektfilen som definieras före <import> av SharePoint-målfilen.

Om du till exempel vill lägga till filnamnstilläggen (.myextension och .yourextension) i listan över filnamnstillägg för tokenersättning lägger du till följande i en projektfil (.csproj):

<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>

Du kan lägga till tillägget direkt i målfilen (.targets). Om du lägger till tillägget ändras dock tilläggslistan för alla SharePoint-projekt som paketeras i det lokala systemet, inte bara dina egna. Det här tillägget kan vara praktiskt när du är den enda utvecklaren i systemet eller om de flesta av dina projekt kräver det. Men eftersom det är systemspecifikt är den här metoden inte portabel, och därför rekommenderar vi att du lägger till eventuella tillägg i projektfilen i stället.

Relaterat innehåll

• Utveckla SharePoint-lösningar