Parametry wymienne
Parametry wymienne lub tokenów, może być używana wewnątrz plików projektu, aby podać wartości dla elementów rozwiązanie programu SharePoint, w których wartości rzeczywiste nie są znane w czasie projektowania.Są one podobne w funkcji standardu Visual Studio tokenów szablonu. Aby uzyskać więcej informacji, zobacz Parametry szablonu.
Token Format
Tokeny rozpoczyna i kończy się znakiem dolara ($).Wszystkie tokeny służące zastępuje się z wartościami rzeczywistymi projektu jest pakowany w pliku pakietu (wsp) rozwiązanie programu SharePoint, w czasie rozmieszczania.Na przykład token $SharePoint.Package.Name$ może rozwiązać na ciąg "Test pakietu SharePoint".
Token reguł
Następujące zasady stosuje się do tokenów:
Tokeny można określić dowolne miejsce w linii.
Tokeny 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 może być określona w tym samym wierszu.
Tokeny, które nie przestrzegają tych zasad są ignorowane, bez podawania, ostrzeżenie lub błąd.
Zastąpienie tokeny przez ciąg wartości odbywa się natychmiast po transformacji manifestu, umożliwiając w ten sposób manifestu szablony edytowane przez użytkownika, używając tokenów.
.gif "Ee231545.collapse_all(pl-pl,VS.110).gif")
Token rozpoznawania nazw
W większości przypadków token rozpoznaje określoną wartość, bez względu na to, gdzie jest on zawarty.Jeśli token jest związane z pakietu lub funkcji, wartość tokenu zależy jednak gdzie jest on zawarty.Na przykład, jeśli funkcja jest w pakiet, a następnie token $SharePoint.Package.Name$ jest rozpoznawany jako wartość "Pakiet A." Jeśli funkcja sam jest w pakiet B, następnie $SharePoint.Package.Name$ jest 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$ |
Nazwy zawierające plik 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 Zgromadzenia, konwertowane na ciąg.(16 znaków "x 2" szesnastkowej.) |
$SharePoint.Package.name$ |
Nazwa pakietu zawierającego. |
$SharePoint.Package.filename$ |
Nazwa pliku definicji pakietu zawierającego. |
$SharePoint.Package.FileNameWithoutExtension$ |
Nazwa (bez rozszerzenia) w pliku definicji pakietu zawierającego. |
$SharePoint.Package.ID$ |
Identyfikator programu SharePoint, zawierające 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 przyrównuje się do właściwości "Ścieżki rozmieszczania" w Projektancie funkcji.Jest przykład wartość "Project1_Feature1". |
$SharePoint.Feature.ID$ |
Identyfikator programu SharePoint zawierającej funkcję.Ten token, jak z wszystkich funkcji na poziomie tokenów, może być używany tylko przez pliki w pakiecie za pośrednictwem funkcji, nie dodawane bezpośrednio do pakietu, poza funkcją. |
$SharePoint.ProjectItem.name$ |
Nazwa elementu projektu (nie jego nazwa pliku), uzyskanych z ISharePointProjectItem.Name. |
$SharePoint.Type. <GUID>.AssemblyQualifiedName$ |
Nazwa kwalifikowana zestawu pasujących typu GUID tokenu. Format GUID jest małymi literami i odpowiada formatowi Guid.ToString("D") (to znaczy xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). |
$SharePoint.Type. <GUID>.Imię i nazwisko$ |
Pełna nazwa typu pasującego do identyfikatora GUID w tokenie.Format identyfikatora GUID jest mała i odpowiada formatowi Guid.ToString("D") (to znaczy xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). |
Dodawanie rozszerzeń do listy rozszerzeń plików wymiany Token
Mimo, że tokeny, teoretycznie mogą być używane przez każdy plik, który należy do przedmiotu zawarte w pakiecie, domyślnie projekt SharePoint Visual Studio wyszukuje tokenów tylko w plikach pakietu, pliki manifestu oraz pliki, które mają następujące rozszerzenia:
XML
ASCX
ASPX
Składnik Web Part
DWP
Rozszerzenia te są zdefiniowane przez <TokenReplacementFileExtensions> elementu w pliku Microsoft.VisualStudio.SharePoint.targets w... \ < pliki programu > \MSBuild\Microsoft\VisualStudio\v11.0\SharePointTools folder.
Można jednak dodać dodatkowe rozszerzenia plików do listy.Aby to zrobić, należy dodać <TokenReplacementFileExtensions> element do wszelkich PropertyGroup w pliku projektu programu SharePoint, który jest zdefiniowany przed <Import> pliku cele programu SharePoint.
[!UWAGA]
Ponieważ projekt jest skompilowany zastępowania tokenu, 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ć rozszerzenia nazwy pliku ".myextension" i ".yourextension" do listy rozszerzeń nazw plików zastępowania tokenu, 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że ten zmienia listy rozszerzeń dla wszystkich projektów programu SharePoint, pakowane w systemie lokalnym, nie tylko swoje własne.Może to być wygodne, gdy jesteś jedynym autora w systemie, lub jeśli większość projektów wymaga to.Jednak jest specyficzne dla systemu, takie podejście nie jest przenośny i dlatego zalecane jest, należy dodać wszystkie rozszerzenia pliku projektu zamiast.