Parametri sostituibili

I parametri sostituibili, o token, possono essere utilizzati nei file di progetto per fornire valori agli elementi di soluzione SharePoint i cui valori effettivi non sono noti in fase di progettazione.Funzione è simile a quella dei token standard del modello Visual Studio. Per ulteriori informazioni, vedere Parametri di template.

Formato dei token

I token iniziano e terminano con un segno di dollaro ($).Qualsiasi token utilizzato viene sostituito con valori effettivi quando, in fase di distribuzione, un progetto viene assemblato in un file del pacchetto della soluzione SharePoint (con estensione wsp).Ad esempio, il token $SharePoint.Package.Name$ potrebbe essere risolto nella stringa "Pacchetto di SharePoint di prova".

Regole dei token

Ai token si applicano le regole seguenti:

• I token possono essere specificati in qualsiasi punto di una riga.

• I token non possono estendersi su più righe.

• È possibile specificare più volte lo stesso token sulla medesima riga e nello stesso file.

• È possibile specificare token diversi sulla stessa riga.

I token che non rispettano queste regole vengono ignorati senza previa visualizzazione di avvisi o errori.

La sostituzione dei token con valori stringa viene immediatamente eseguita dopo la trasformazione del manifesto, consentendo pertanto ai modelli di manifesto modificati da un utente di utilizzare token.

Risoluzione dei nomi dei token

Nella maggior parte dei casi, un token viene risolto in un valore specifico indipendentemente dall'elemento che lo contiene.Tuttavia, se il token è correlato a un pacchetto o una funzionalità, il relativo valore dipende dall'elemento che lo contiene.Ad esempio, se una funzionalità si trova nel pacchetto A, il token $SharePoint.Package.Name$ viene risolto nel valore "Pacchetto A". Se la stessa funzionalità si trova nel pacchetto B, $SharePoint.Package.Name$ viene risolto in "Pacchetto B".

Elenco di token

Nella tabella seguente sono elencati i token disponibili.

Aggiunta di estensioni all'elenco di estensioni di file sostitutive dei token

Sebbene i token possano essere utilizzati in teoria da qualsiasi file che appartiene a un elemento del progetto SharePoint incluso nel pacchetto, per impostazione predefinita Visual Studio consente di cercare i token solo nei file di pacchetto, nei file manifesto e nei file con le estensioni seguenti:

• XML

• ASCX

• ASPX

• Webpart

• DWP

Queste estensioni vengono definite dall'elemento <TokenReplacementFileExtensions> nel file Microsoft.VisualStudio.SharePoint.targets, situato nella cartella… \<program files>\ MSBuild \ Microsoft \ VisualStudio \ v11.0 cartella \ SharePointTools.

Tuttavia, è possibile aggiungere estensioni di file aggiuntive all'elenco.A tal fine, aggiungere un elemento <TokenReplacementFileExtensions> a qualsiasi elemento PropertyGroup del file di progetto SharePoint definito prima dell'importazione del file targets di SharePoint.

[!NOTA]

Poiché la sostituzione dei token avviene dopo la compilazione di un progetto, non è necessario aggiungere estensioni di file per i tipi di file compilati, ad esempio cs, vb o resx.I token vengono sostituiti solo nei file non compilati.

Ad esempio, per aggiungere le estensioni di file "myextension" e "yourextension" all'elenco di estensioni di file sostitutive dei token è necessario aggiungere quanto riportato di seguito a un file con estensione 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>

In alternativa, è possibile aggiungere direttamente l'estensione al file con estensione targets.Tale operazione, però, modifica l'elenco di estensioni per tutti i progetti SharePoint assemblati nel sistema locale, non solo per il proprio.Pertanto risulta conveniente se si è l'unico sviluppatore del sistema o se la maggior parte dei progetti richiede questa modifica.Tuttavia, essendo specifico del sistema questo approccio non è molto portabile, pertanto si consiglia di aggiungere le estensioni al file di progetto.

Vedere anche

Altre risorse

Sviluppo di soluzioni SharePoint