Vytvoření položky šablony a šablony aplikace Project pro položky služby SharePoint projektu

Článek
03/04/2013

Při definování vlastního typu položky projektu SharePoint, můžete jej spojit s šablonou projektu nebo šablony položky, aby ostatním vývojářům použít položku projektu v aplikaci Visual Studio.Můžete také vytvořit průvodce šablony.

Například Visual Studio neobsahuje šablonu projektu nebo šablony položky pro přidání pole do webu služby SharePoint.Můžete definovat typ položky projektu služby SharePoint, který představuje pole a potom vytvořit šablonu položky, které mohou vývojáři přidat pole položku projektu služby SharePoint.Nebo můžete vytvořit šablonu projektu, takže vývojáři mohou vytvořit nový projekt SharePoint, obsahující položky pole. V obou případech můžete zadat také průvodce, který se zobrazí, pokud vývojáři použít šablonu.Tohoto průvodce lze shromažďovat informace vývojářům konfigurovat nové položky nebo projektu.

Položky šablony a šablony projektu jsou soubory ZIP, které obsahují soubory používané v aplikaci Visual Studio k vytvoření položky projektu nebo projekt.Další informace o základy položky šablony a šablony projektu viz Úvod k šablonám aplikace Visual Studio.

Vytvoření šablony položek

Pokud vytvoříte šablonu položky pro položku projektu služby SharePoint, jsou některé soubory, které jsou vždy povinné a volitelné soubory, které mohou používat určité typy položek projektuNávod, který demonstruje definování typu položky projektu služby SharePoint a vytvořit šablonu položky, viz Názorný postup: Vytváření projektu vlastní akci pomocí položky šablony, část 1.

Následující tabulka uvádí požadované soubory vytvořit šablonu položky pro položku projektu služby SharePoint.

Požadovaný soubor	Description
Soubor .spdata	Toto je soubor XML, který určuje obsah a chování položky projektu.Tento soubor musí být součástí šablony položky.Další informace o obsahu .spdata souborů naleznete v tématu Referenční schéma SharePoint položky.
Soubor .vstemplate.	Tento soubor poskytuje informace potřebné k zobrazení šablony v aplikaci Visual Studio Přidat novou položku dialogové okno a vytvoření položky projektu z šablony.Tento soubor musí být součástí šablony položky.Další informace naleznete v tématu Visual Studio Template Metadata Files.
Sestavení rozšíření aplikace Visual Studio, které implementuje ISharePointProjectItemTypeProvider rozhraní.	Toto sestavení definuje chování běhu položky projektu.Toto sestavení musí být zahrnut v balíčku VSIX pomocí šablony položky.Další informace naleznete v tématu Definování typů položek projektu SharePoint vlastní a Nasazování rozšíření pro nástroje služby SharePoint v aplikaci Visual Studio.

V následující tabulce jsou uvedeny některé nejběžnější volitelné soubory, které lze zahrnout do šablony položky.Některé typy položek projektu může vyžadovat další soubory, které zde nejsou uvedeny.

Volitelný soubor	Description
Elements.XML	A element funkce souboru.Tento soubor definuje uživatelské rozhraní a chování vlastní vytvořené položky projektu.Každý typ vlastního nastavení, například seznam instancí, typů obsahu nebo vlastní akce má odlišné schéma definující obsah tohoto souboru.Další informace naleznete v stavební blok: funkce a Funkce schémata.
Schema.XML	Soubor schématu pro seznam definic.Další informace naleznete v stavební blok: seznamy a knihovny dokumentů a Schema.xml.
WebPart	A definice webové části souboru.Tento soubor obsahuje nastavení vlastnosti webové části.Další informace naleznete v stavební blok: webové části.
ASCX	Soubor ASP.NET UserControl.Tento soubor definuje rozhraní Visual Web Part.
.aspx	Souboru stránky ASP.NET.Tento soubor obsahuje kód XML, který definuje stránku aplikace.
soubory CS nebo VB	Tyto soubory kódu definují chování přizpůsobení SharePoint, které mají programovací model, který je přístupný z Visual C# nebo kódu jazyka Visual Basic aplikace stránek, webových částí a pracovní postupy.

Vytváření šablon projektů

Při vytváření šablony projektu služby SharePoint jsou některé soubory, které jsou vždy povinné a volitelné soubory, které mohou používat určité typy projektů.Projekty SharePoint obvykle obsahovat alespoň jednu položku projektu služby SharePoint.Není to však povinné.Například můžete definovat šablony projektu SharePoint, který je určen pouze pro nasazení řešení SharePoint vytvořené v jiných projektech.

Návod, který demonstruje definování typu položky projektu služby SharePoint a vytvořit šablonu projektu, viz Názorný postup: Vytvoření položky projektu sloupec webu pomocí šablony projektu, část 1.

V následující tabulce jsou uvedeny soubory, které musí být součástí šablony projektu služby SharePoint.

Požadovaný soubor	Description
Soubor .vstemplate	Tento soubor poskytuje informace potřebné k zobrazení šablony v aplikaci Visual Studio Nový projekt dialogové okno a vytvoření projektu z šablony.Další informace naleznete v tématu Visual Studio Template Metadata Files.
Soubor csproj nebo VBPROJ	Toto je soubor projektu.Definuje obsah a nastavení konfigurace projektu.
Package.Package	Tento soubor definuje balíček nasazení pro projekt.Při použití návrháře balíček upravit balíček řešení projektu sady Visual Studio ukládá data o balíčku řešení v tomto souboru. Při vytváření vlastní šablony projektu SharePoint doporučujeme zahrnout pouze minimální požadovaný obsah souboru Package.package a konfigurace balíčku řešení pomocí rozhraní API v Microsoft.VisualStudio.SharePoint.Packages oboru názvů rozšíření, který je spojen se šablonou projektu.Pokud to uděláte, šablony projektu je chráněn z budoucí změny struktury souboru Package.package.Příklad ukazuje, jak vytvořit soubor Package.package s pouze požadované minimum obsahu, viz Názorný postup: Vytvoření položky projektu sloupec webu pomocí šablony projektu, část 1. Pokud chcete upravit přímo soubor Package.package, můžete ověřit obsah pomocí schématu % Program Files (x86)%\Microsoft Visual Studio 11.0\Xml\Schemas\PackageModelSchema.xsd.
Package.Template.xml	Tento soubor je základem pro soubor manifestu řešení (manifest.xml) pro balíček řešení SharePoint (WSP), který je generován z projektu.Pokud chcete zadat některé chování, které není určeno pro uživatelé vašeho typu projektu změnit, můžete přidat obsah do tohoto souboru.Další informace naleznete v stavební blok: řešení a Schéma řešení. Při vytváření balíčku řešení z projektu Visual Studio sloučí obsah Package.package a Package.Template.xml soubory do roztoku soubor manifestu.Další informace o vytváření balíčků řešení viz Jak: vytvoření balíčku řešení služby SharePoint v aplikaci Visual Studio.

Následující tabulka uvádí volitelné soubory, které mohou být zahrnuty v šabloně projektu.

Volitelný soubor	Description
Položky projektu SharePoint	Může obsahovat jeden nebo více souborů .spdata definující typy položek projektu služby SharePoint.Každý soubor .spdata musí mít odpovídající ISharePointProjectItemTypeProvider implementace rozšíření sestavení, která je součástí balíčku VSIX pomocí šablony projektu.Další informace naleznete v Vytváření šablon položek. Projekty SharePoint obvykle obsahovat alespoň jednu položku projektu služby SharePoint.Není to však povinné.
Název_funkce.feature	Tento soubor definuje funkce služby SharePoint, která slouží k seskupení více položek projektu nasazení.Při použití funkce Návrhář přizpůsobit funkce v projektu Visual Studio ukládá data o funkci v tomto souboru.Pokud chcete seskupit položky projektu do různých funkcí, můžete zahrnout více souborů .feature. Při vytváření vlastní šablony projektu SharePoint doporučujeme zahrnout pouze minimální požadovaný obsah každého souboru .feature, a nakonfigurovat funkce pomocí rozhraní API v Microsoft.VisualStudio.SharePoint.Features oboru názvů rozšíření, který je spojen se šablonou projektu.Pokud to uděláte, šablony projektu je chráněn z budoucí změny struktury souboru .feature.Příklad ukazuje, jak vytvořit soubor .feature s pouze požadované minimum obsahu, viz Názorný postup: Vytvoření položky projektu sloupec webu pomocí šablony projektu, část 1. Pokud chcete upravit přímo soubor .feature, můžete ověřit obsah pomocí schématu % Program Files (x86)%\Microsoft Visual Studio 11.0\Xml\Schemas\FeatureModelSchema.xsd.
Název_funkce.Template.XML	Tento soubor je základem pro soubor manifestu funkce (souboru funkce.XML) pro každou funkci, která je generována z projektu.Pokud chcete zadat některé chování, které není určeno pro uživatelé vašeho typu projektu změnit, můžete přidat obsah do tohoto souboru.Další informace naleznete v stavební blok: funkce a souboru funkce.XML soubory. Při vytváření balíčku řešení projektu sady Visual Studio sloučí obsah každé dvojice Název_funkcesoubor .feature a Název_funkce.Template.XML soubory do souboru manifestu funkcí.Další informace o vytváření balíčků řešení viz Jak: vytvoření balíčku řešení služby SharePoint v aplikaci Visual Studio.

Položky projektu SharePoint

Může obsahovat jeden nebo více souborů .spdata definující typy položek projektu služby SharePoint.Každý soubor .spdata musí mít odpovídající ISharePointProjectItemTypeProvider implementace rozšíření sestavení, která je součástí balíčku VSIX pomocí šablony projektu.Další informace naleznete v Vytváření šablon položek.

Projekty SharePoint obvykle obsahovat alespoň jednu položku projektu služby SharePoint.Není to však povinné.

Název_funkce.feature

Tento soubor definuje funkce služby SharePoint, která slouží k seskupení více položek projektu nasazení.Při použití funkce Návrhář přizpůsobit funkce v projektu Visual Studio ukládá data o funkci v tomto souboru.Pokud chcete seskupit položky projektu do různých funkcí, můžete zahrnout více souborů .feature.

Při vytváření vlastní šablony projektu SharePoint doporučujeme zahrnout pouze minimální požadovaný obsah každého souboru .feature, a nakonfigurovat funkce pomocí rozhraní API v Microsoft.VisualStudio.SharePoint.Features oboru názvů rozšíření, který je spojen se šablonou projektu.Pokud to uděláte, šablony projektu je chráněn z budoucí změny struktury souboru .feature.Příklad ukazuje, jak vytvořit soubor .feature s pouze požadované minimum obsahu, viz Názorný postup: Vytvoření položky projektu sloupec webu pomocí šablony projektu, část 1.

Pokud chcete upravit přímo soubor .feature, můžete ověřit obsah pomocí schématu % Program Files (x86)%\Microsoft Visual Studio 11.0\Xml\Schemas\FeatureModelSchema.xsd.

Název_funkce.Template.XML

Tento soubor je základem pro soubor manifestu funkce (souboru funkce.XML) pro každou funkci, která je generována z projektu.Pokud chcete zadat některé chování, které není určeno pro uživatelé vašeho typu projektu změnit, můžete přidat obsah do tohoto souboru.Další informace naleznete v stavební blok: funkce a souboru funkce.XML soubory.

Při vytváření balíčku řešení projektu sady Visual Studio sloučí obsah každé dvojice Název_funkcesoubor .feature a Název_funkce.Template.XML soubory do souboru manifestu funkcí.Další informace o vytváření balíčků řešení viz Jak: vytvoření balíčku řešení služby SharePoint v aplikaci Visual Studio.

Vytvoření průvodců pro položku šablony a šablony projektu

Po definování typu položky projektu služby SharePoint a přidružit šablonu projektu nebo položky, můžete také vytvořit průvodce.Průvodce zobrazí, když vývojář používá šablonu položky do projektu přidat položky projektu služby SharePoint nebo vývojář používá šablonu projektu k vytvoření nového projektu, který obsahuje položky projektu služby SharePoint.Průvodce lze shromažďovat informace od vývojářů a inicializovat nové položky projektu služby SharePoint.

Návody, které ukazují, jak vytvořit průvodci pro šablony projektu a šablon položek, viz Názorný postup: Vytváření projektu vlastní akci pomocí položky šablony, část 2 a Názorný postup: Vytvoření položky projektu sloupec webu pomocí šablony projektu, část 2.