共用方式為

Visual Studio 範本資訊清單結構描述參考

  • 發行項

 

發行︰ 2016年7月

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件。

此結構描述會描述針對 Visual Studio 專案或項目樣板所產生的 Visual Studio 範本資訊清單 (.vstman) 檔案格式，並描述的位置和其他範本的相關資訊。

︰ 由於有個別的項目和專案範本目錄中，資訊清單應該永遠不會有項目和專案範本的混合。

重要

此資訊清單是從開始在 Visual Studio"15"Preview 2 中提供。

VSTemplateManifest 項目

資訊清單的根項目。

屬性

  • 版本︰ 字串，表示範本資訊清單的版本。 必要項。

  • 地區設定︰ 字串，表示範本資訊清單的地區設定的地區設定。 地區設定值套用至所有範本，因此您必須使用不同的資訊清單，每個地區設定。 選擇項。

子項目

  • VSTemplateContainer選擇性。

  • VSTemplateDir選擇性。

Parent 項目

無。

VSTemplateContainer

資訊清單的項目範本的容器。 資訊清單中有一個範本容器，它會定義每個範本。

屬性

VSTemplateType ︰ 指定的範本類型的字串值 ("Project"， "Item"，或"ProjectGroup")。 必要

子項目

  • RelativePathOnDisk︰ 磁碟上的範本檔案的相對路徑。 此位置也會定義範本的位置在範本樹狀目錄中所示新的專案或新項目] 對話方塊。 部署目錄和個別檔案為範本，此路徑是指包含範本檔案的目錄。 範本部署為.zip 檔案，此路徑應.zip 檔案的路徑。

  • VSTemplateHeader : A TemplateData描述標頭的項目。

Parent 項目

VSTemplateManifest

VSTemplateDir

描述範本所在的目錄。 資訊清單可以包含多個VSTemplateDir提供當地語系化的名稱和排序順序目錄控制其外觀範本類別目錄樹狀結構中的項目。

因為它們的設計， VSTemplateDir應該只在非地區設定的指定資訊清單中出現項目。

屬性

無。

子項目

  • RelativePath︰ 範本的路徑。 可以有只有一個項目，每個路徑，因此第一個會為所有的資訊清單中獲得優先權。

  • LocalizedName: A NameDescriptionIcon項目，指定當地語系化的名稱。 選擇項。

  • SortOrder ︰ 字串，指定排序次序。 選擇項。

  • ParentFolderOverrideName︰ 覆寫的父資料夾的名稱。 選擇項。 這個項目有名稱屬性，也就是指定名稱的字串值。

Parent 項目

VSTemplateManifest

NameDescriptionIcon

指定的名稱和描述，可能是當地語系化的範本。 請參閱LocalizedName上方。

屬性

  • 封裝︰ 指定的封裝的字串值。 選擇項。

  • 識別碼︰ 字串值，指定識別碼。 選擇項。

子項目

無。

Parent 項目

LocalizedName

範例

以下是專案範本.vstman 檔案的範例。

<VSTemplateManifest Version="1.0" Locale="1033" xmlns="https://schemas.microsoft.com/developer/vstemplatemanifest/2015">  
  <VSTemplateContainer TemplateType="Project">  
    <RelativePathOnDisk>CSharp\1033\TestProjectTemplate</RelativePathOnDisk>  
    <TemplateFileName>TestProjectTemplate.vstemplate</TemplateFileName>  
    <VSTemplateHeader>  
      <TemplateData xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">  
        <Name>TestProjectTemplate</Name>  
        <Description>TestProjectTemplate</Description>  
        <Icon>TestProjectTemplate.ico</Icon>  
        <ProjectType>CSharp</ProjectType>  
        <RequiredFrameworkVersion>2.0</RequiredFrameworkVersion>  
        <SortOrder>1000</SortOrder>  
        <TemplateID>aac0aeea-7883-4003-992f-937d53d70ab1</TemplateID>  
        <CreateNewFolder>true</CreateNewFolder>  
        <DefaultName>TestProjectTemplate</DefaultName>  
        <ProvideDefaultName>true</ProvideDefaultName>  
      </TemplateData>  
    </VSTemplateHeader>  
  </VSTemplateContainer>  
</VSTemplateManifest>

項目範本.vstman 檔案的範例如下。

VSTemplateManifest Version="1.0" Locale="1033" xmlns="https://schemas.microsoft.com/developer/vstemplatemanifest/2015">  
  <VSTemplateContainer TemplateType="Item">  
    <RelativePathOnDisk>CSharp\1033\ItemTemplate1</RelativePathOnDisk>  
    <TemplateFileName>ItemTemplate1.vstemplate</TemplateFileName>  
    <VSTemplateHeader>  
      <TemplateData xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">  
        <Name>ItemTemplate1</Name>  
        <Description>ItemTemplate1</Description>  
        <Icon>ItemTemplate1.ico</Icon>  
        <TemplateID>bfeadf8e-a251-4109-b605-516b88e38c8d</TemplateID>  
        <ProjectType>CSharp</ProjectType>  
        <RequiredFrameworkVersion>2.0</RequiredFrameworkVersion>  
        <NumberOfParentCategoriesToRollUp>1</NumberOfParentCategoriesToRollUp>  
        <DefaultName>Class.cs</DefaultName>  
      </TemplateData>  
    </VSTemplateHeader>  
  </VSTemplateContainer>  
</VSTemplateManifest>