Parametry wymienne
Parametry wymienne, lub tokenów, można używać wewnątrz pliki projektu dotyczące wartości dla elementów rozwiązanie programu SharePoint, których wartości rzeczywiste nie są znane w czasie projektowania.Są one podobne w funkcji z normą Visual Studio tokenów szablonu.Aby uzyskać więcej informacji, zobacz Parametry szablonu.
Format tokenu
Tokeny zaczynają się i kończą się znakiem dolara ($).Wszystkie tokeny używane są zastępowane wartościami rzeczywistymi podczas projektu jest pakowany w pliku pakietu (wsp) rozwiązanie programu SharePoint, w czasie wdrażania.Na przykład tokenem $SharePoint.Package.Name$ może rozwiązać na ciąg "Test pakiet programu SharePoint".
Token reguł
Aby tokeny obowiązują następujące reguły:
Tokeny można określić dowolne miejsce w linii.
Tokenów nie może obejmować wiele wierszy.
Token ten sam może być określone wiele razy w tym samym wierszu i w tym samym pliku.
Tokeny różnych mogą być określone w tym samym wierszu.
Tokeny, które nie przestrzegają tych zasad są ignorowane bez podawania, ostrzeżenie lub błąd.
Zastąpienie tokeny przez wartości ciągu odbywa się natychmiast po przekształceniu manifestu, umożliwiając tym samym manifestu szablony edytowane przez użytkownika, aby użyć tokenów.
Nazwa tokenu rozdzielczość
W większości przypadków token jest rozpoznawany jako określonej wartości bez względu na to, gdzie jest on zawarty.Jednak jeśli token jest związany z pakietu lub funkcji, wartość tokenu zależy gdzie jest on zawarty.Na przykład, jeśli funkcja znajduje się w pakiet, a następnie token $SharePoint.Package.Name$ rozpoznawany jako wartość "Pakiet A." Jeśli jedna funkcja jest w pakiecie B, następnie $SharePoint.Package.Name$ rozpoznawany jako "Pakiet B."
Listy tokenów
Poniższa lista zawiera dostępne tokeny.
Nazwa |
Opis |
|---|---|
$SharePoint.Project.FileName$ |
Nazwa pliku zawierającego projektu, takie jak "NewProj.csproj". |
$SharePoint.Project.FileNameWithoutExtension$ |
Nazwa pliku zawierającego projektu bez rozszerzenia nazwy pliku.Na przykład, "NewProj". |
$SharePoint.Project.AssemblyFullName$ |
Nazwa wyświetlana (silnej nazwy) projektu zawierającego wyjściowych zestawu. |
$SharePoint.Project.AssemblyFileName$ |
Nazwa projektu zawierającego wyjściowych zestawu. |
$SharePoint.Project.AssemblyFileNameWithoutExtension$ |
Nazwa projektu zawierającego wyjściowych zestawu bez rozszerzenia nazwy pliku. |
$SharePoint.Project.AssemblyPublicKeyToken$ |
Token klucza publicznego projektu zawierającego wyjściowych zestawu konwertowany jest na ciąg. (16 znaków "x 2" szesnastkowej.) |
$SharePoint.Package.Name$ |
Nazwa pakietu. |
$SharePoint.Package.FileName$ |
Nazwa pliku definicji pakietu zawierającego. |
$SharePoint.Package.FileNameWithoutExtension$ |
Nazwa (bez rozszerzenia) zawierającego pakiet pliku definicji. |
$SharePoint.Package.Id$ |
Identyfikator programu SharePoint dla zawierającego pakiet.Jeśli funkcja jest używany w więcej niż jeden pakiet, wartość ta zostanie zmieniona. |
$SharePoint.Feature.FileName$ |
Nazwa pliku definicji zawierające funkcji, takich jak Feature1.feature. |
$SharePoint.Feature.FileNameWithoutExtension$ |
Nazwa pliku definicji funkcji bez rozszerzenia nazwy pliku. |
$SharePoint.Feature.DeploymentPath$ |
Nazwa folderu, który zawiera funkcję w pakiecie.Token ten jest równa właściwości "Path wdrażania" w Projektancie funkcji.Na przykład wartość jest "Project1_Feature1". |
$SharePoint.Feature.Id$ |
Identyfikator programu SharePoint zawierającej funkcję.Ten token z wszystkich tokenów poziom funkcji, może być używany tylko przez pliki zawarte w pakiecie za pośrednictwem funkcji, nie dodawane bezpośrednio do pakietu poza funkcją. |
$SharePoint.ProjectItem.Name$ |
Nazwa elementu projektu (nie jej nazwa pliku), uzyskanych z ISharePointProjectItem.Name. |
$SharePoint.Type.<GUID>.AssemblyQualifiedName$ |
Nazwa kwalifikowana zestawu typ dopasowania GUID tokenu.Format GUID jest małymi i odpowiada formatowi Guid.ToString("D") (to znaczy xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). |
$SharePoint.Type.<GUID>.Imię i nazwisko$ |
Pełna nazwa typu dopasowania identyfikatora GUID w tokenie.Format identyfikatora GUID jest mała litera i odpowiada formatowi Guid.ToString("D") (to znaczy xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). |
Dodawanie rozszerzeń do zastępowania tokenu pliku Lista rozszerzeń
Mimo, że tokeny teoretycznie mogą być używane przez każdy plik, który należy do projektu programu SharePoint element zawarte w pakiecie, domyślnie, Visual Studio wyszukuje tokenów tylko w plikach pakiet, pliki manifest i pliki, które mają następujące rozszerzenia:
XML
ASCX
ASPX
Składnik Web Part
DWP
Rozszerzenia te są definiowane przez <TokenReplacementFileExtensions> elementu w pliku Microsoft.VisualStudio.SharePoint.targets, znajdujące się w... \<pliki programów>\MSBuild\Microsoft\VisualStudio\v11.0\SharePointTools folder.
Można jednak dodać dodatkowe rozszerzenia plików do listy.Aby to zrobić, Dodaj <TokenReplacementFileExtensions> element do wszelkich PropertyGroup w pliku projektu programu SharePoint, który jest zdefiniowany przed <importowania> pliku cele programu SharePoint.
[!UWAGA]
Ponieważ zastępowania tokenu występuje skompilowany projektu, nie należy dodawać rozszerzenia plików dla typów plików, które są zestawiane, na przykład CS, .vb lub resx.Tokeny są zastępowane tylko w plikach, które nie są sporządzane.
Na przykład aby dodać do listy rozszerzeń nazw plików zastępowania tokenu rozszerzenia nazwy pliku ".myextension" i ".yourextension", należy dodać następujące w pliku .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>
Alternatywnie można dodać rozszerzenia bezpośrednio do pliku .targets.Jednak w ten sposób zmienia listy rozszerzeń dla wszystkich projektów programu SharePoint zapakowane w systemie lokalnym, nie tylko własne.Może to być wygodne, gdy jesteś deweloperem wyłącznie w systemie lub jeśli większość projektów wymaga to.Jednak ponieważ jest specyficzne dla systemu, ta metoda nie jest przenośny i dlatego zalecane jest dodać wszystkie rozszerzenia pliku projektu zamiast.