T4 Dyrektywy zestawu
W Visual Studio tekst w czasie projektowania szablonu, assembly dyrektywy ładuje zgromadzenie tak, aby w kodzie szablonu można użyć jego typów.Efekt jest podobny do Dodawanie odwołania do zestawu w Visual Studio projektu.
Ogólne omówienie pisania tekstu szablonów, zobacz Zapisywanie szablonu tekst T4.
[!UWAGA]
Nie trzeba assembly dyrektywy w szablonie run-time (wstępnie) tekstu.Zamiast tego Dodaj niezbędnych zestawów do odniesienia z sieci Visual Studio projektu.
Za pomocą dyrektywy zestawu
Składnia tej dyrektywy jest w następujący sposób:
<#@ assembly name="[assembly strong name|assembly file name]" #>
Nazwa zestawu powinna być jedną z następujących czynności:
Silnej nazwy zestawu w pamięci podręcznej GAC, takich jak System.Xml.dll.Można również użyć długą formę, takich jak name="System.Xml, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089".Aby uzyskać więcej informacji, zobacz AssemblyName.
Bezwzględna ścieżka zestawu
Można użyć $(variableName) składni, aby odwołać się za Visual Studio lub MSBuild zmiennych, takich jak $(SolutionDir), i %VariableName% do zmiennych środowiskowych odniesienia.Na przykład:
<#@ assembly name="$(SolutionDir)\MyProject\bin\Debug\SomeLibrary.Dll" #>
Dyrektywy Zgromadzenie nie ma wpływu w szablonie wstępnie przetworzony format tekstu.Zamiast tego zawierać niezbędne odwołania w odniesienia sekcji your Visual Studio projektu.Aby uzyskać więcej informacji, zobacz Generowanie tekstu Run-Time z szablonami tekst T4.
Standard zestawów
Następujące zespoły są ładowane automatycznie, tak aby nie trzeba pisać dyrektyw zestawu dla nich:
Microsoft.VisualStudio.TextTemplating.1*.dll
System.dll
WindowsBase.dll
Użycie dyrektywy niestandardowe, dyrektywa procesor może załadować dodatkowych zestawów.Na przykład jeśli piszesz szablonów dla języka specyficzne dla domeny (DSL), nie trzeba pisać dyrektyw zestawu dla następujących zestawów:
Microsoft.VisualStudio.Modeling.Sdk.1*.dll
Microsoft.VisualStudio.Modeling.Sdk.Diagrams.1*.dsl
Microsoft.VisualStudio.TextTemplating.Modeling.1*.dll
Zgromadzenie, zawierające modem DSL.