Tworzenie elementu szablonów i szablony projektu dla elementów projektu programu SharePoint

Artykuł
02/27/2013

Podczas definiowania niestandardowych typu element projektu programu SharePoint można skojarzyć z szablon towaru lub szablon projektu, tak aby inni programiści mogą wykorzystać element projektu w programie Visual Studio.Można również utworzyć Kreatora szablonu.

Na przykład Visual Studio nie ma szablonu projektu lub szablonu towaru dla dodawania pola do witryny programu SharePoint.Można zdefiniować typ elementu projektu programu SharePoint, który reprezentuje pole i zbudować szablonu elementu, który inni programiści mogą wykorzystać do dodawania elementu pola do projektu programu SharePoint.Lub można utworzyć szablon projektu, dzięki czemu deweloperzy mogą tworzyć nowy projekt programu SharePoint, który zawiera element pola. W obu przypadkach można również dołączyć kreatora, który pojawia się, gdy programiści przy użyciu szablonu.Tego kreatora można zbierać informacje od programistów, aby skonfigurować nowy element lub projektu.

Element szablonów i szablony projektu są pliki zip, które zawierają pliki, które są używane przez Visual Studio, aby utworzyć element projektu lub projektu.Aby uzyskać więcej informacji na temat podstaw szablony elementów i szablonów projektu, zobacz Wprowadzenie do programu Visual Studio, szablony.

Tworzenie szablonów zapasów

Podczas tworzenia szablonu towaru dla elementu projektu programu SharePoint są pewne pliki, które są zawsze wymagane i opcjonalne pliki, które mogą być wykorzystywane przez niektóre rodzaje elementów projektu.Instruktaż, który pokazuje, jak określić typ elementu programu SharePoint projektu i utworzyć szablon towaru dla niego, zobacz Instruktaż: Tworzenie elementu projektu działania niestandardowe z szablonu elementu, część 1.

Poniższa tabela zawiera listę plików wymaganych do utworzenia szablonu towaru dla elementu projektu programu SharePoint.

Wymagany plik	Opis
Plik .spdata	Jest to plik XML, który określa zawartość i zachowanie domyślne elementu projektu.Ten plik musi znajdować się w szablonie elementu.Aby uzyskać więcej informacji na temat zawartości plików, .spdata, zobacz Odwołanie schematu element projektu programu SharePoint.
Plik .vstemplate.	Plik ten zawiera Visual Studio, informacje wymagane do wyświetlania szablonu w Dodaj nowy element okno dialogowe i utworzyć element projektu z szablonu.Ten plik musi znajdować się w szablonie elementu.Aby uzyskać więcej informacji, zobacz Visual Studio Template Metadata Files.
Montaż rozszerzenie programu Visual Studio, który implementuje ISharePointProjectItemTypeProvider interfejsu.	Ten zestaw definiuje zachowanie czas jednostkowy element projektu.Ten zestaw muszą być uwzględnione w pakiecie VSIX z szablonu elementu.Aby uzyskać więcej informacji, zobacz Definiowanie typów elementów projektu programu SharePoint niestandardowe i Wdrażanie rozszerzeń dla narzędzia programu SharePoint w programie Visual Studio.

Poniższa lista zawiera niektóre z najczęściej opcjonalnych plików, które mogą być zawarte w szablonie elementu.Niektóre typy elementów projektu może wymagać innych plików, które nie są wymienione w tym miejscu.

Opcjonalny plik	Opis
Elements.XML	A element funkcji pliku.Ten plik definiuje interfejs użytkownika i zachowanie dostosowywania utworzone przez element projektu.Każdy rodzaj dostosowywania listy wystąpień, typy zawartości lub akcji niestandardowych, ma inny schemat, który definiuje zawartość tego pliku.Aby uzyskać więcej informacji, zobacz bloków konstrukcyjnych: funkcje i Schematów funkcji.
Schema.XML	Plik schematu dla listy definicji.Aby uzyskać więcej informacji, zobacz bloków konstrukcyjnych: list i bibliotek dokumentów i Schema.xml.
WebPart	A definicji składnika Web Part pliku.Ten plik zawiera ustawienia właściwości składnika Web Part.Aby uzyskać więcej informacji, zobacz bloków konstrukcyjnych: składniki Web Part.
.ascx	Plik programu ASP.NET UserControl.Ten plik definiuje UI Visual Web Part.
.aspx	Plik strony ASP.NET.Ten plik zawiera znaczniki XML definiujący strony aplikacji.
pliki z rozszerzeniem .cs lub .vb	Te pliki kodu zdefiniować zachowanie dostosowania programu SharePoint, które mają model programowania, który jest możliwy z Visual C# lub kodu języka Visual Basic, takich jak strony aplikacji, składników Web Part i przepływy pracy.

Tworzenie szablonów projektu

Podczas tworzenia szablonu projektu programu SharePoint, istnieją pewne pliki, które są zawsze wymagane i opcjonalne pliki, które mogą być wykorzystywane przez niektórych rodzajów projektów.Zazwyczaj projekty programu SharePoint zawierają co najmniej jeden element projektu programu SharePoint.Jednakże nie jest to wymagane.Na przykład można zdefiniować szablon projektu programu SharePoint, który ma być używany tylko do wdrażania rozwiązań programu SharePoint utworzonych w innych projektach.

Instruktaż, który pokazuje, jak określić typ elementu programu SharePoint projektu i utworzyć szablon projektu dla niego, zobacz Instruktaż: Tworzenie elementu projektu kolumny witryny z szablonu projektu, część 1.

Poniższa tabela zawiera listę plików, które muszą być zawarte w szablonie projektu programu SharePoint.

Wymagany plik	Opis
Plik .vstemplate	Plik ten zawiera Visual Studio, informacje wymagane do wyświetlania szablonu w Nowy projekt okno dialogowe i utworzyć projekt z szablonu.Aby uzyskać więcej informacji, zobacz Visual Studio Template Metadata Files.
Plik csproj lub .vbproj	Jest to plik projektu.Definiuje zawartość i ustawienia konfiguracji projektu.
Package.Package	Ten plik definiuje pakietu wdrażania projektu.Podczas dostosowywania pakietu rozwiązania dla projektu za pomocą projektanta pakiet Visual Studio są przechowywane dane na temat pakietu rozwiązania w tym pliku. Podczas tworzenia niestandardowego szablonu projektu programu SharePoint, zaleca się zawierać tylko minimalne wymagane zawartości w pliku Package.package i skonfigurować pakiet rozwiązania za pomocą interfejsów API w Microsoft.VisualStudio.SharePoint.Packages obszaru nazw do rozszerzenia, który jest skojarzony z szablonem projektu.Jeśli to zrobisz, Twój szablon projektu, jest on chroniony od przyszłych zmian struktury pliku Package.package.Na przykład, który pokazuje, jak utworzyć plik Package.package tylko minimalne wymagane zawartości, zobacz Instruktaż: Tworzenie elementu projektu kolumny witryny z szablonu projektu, część 1. Jeśli chcesz zmodyfikować plik Package.package bezpośrednio, można sprawdzić zawartość za pomocą schematu % Program Files (11.0\Xml\Schemas\PackageModelSchema.xsd x86)%\Microsoft programu Visual Studio.
Package.Template.xml	Plik ten stanowi podstawę dla pliku manifestu rozwiązania (plik manifest.xml) dla pakietu rozwiązania programu SharePoint (wsp), który jest generowany na podstawie projektu.Jeśli chcesz określić niektóre zachowania, które nie ma być zmieniane przez użytkowników tego typu projektu, można dodać zawartość do tego pliku.Aby uzyskać więcej informacji, zobacz bloków konstrukcyjnych: rozwiązania i Rozwiązanie schematu. Podczas tworzenia pakietu rozwiązań z projektu programu Visual Studio scala zawartość Package.package i plik manifestu plików Package.Template.xml do roztworu.Aby uzyskać więcej informacji o tworzeniu pakiety rozwiązań, zobacz Jak: Tworzenie pakietu rozwiązanie programu SharePoint w programie Visual Studio.

Poniższa tabela zawiera listę opcjonalnych plików, które mogą być zawarte w szablonie projektu.

Opcjonalny plik	Opis
Elementy projektu programu SharePoint	Może zawierać jeden lub więcej plików .spdata, które definiują typy elementów projektu programu SharePoint.Każdy plik .spdata musi mieć odpowiadający mu ISharePointProjectItemTypeProvider realizacji w zestawie rozszerzenia, który jest zawarty w pakiecie VSIX z szablonu projektu.Aby uzyskać więcej informacji, zobacz Tworzenie szablonów elementu. Zazwyczaj projekty programu SharePoint zawierają co najmniej jeden element projektu programu SharePoint.Jednakże nie jest to wymagane.
featureName.feature	Ten plik definiuje funkcji programu SharePoint, który jest używany do grupowania kilka elementów projektu wdrażania.Podczas dostosowywania funkcji w projekcie za pomocą projektanta funkcji Visual Studio są przechowywane dane na temat funkcji w tym pliku.Jeśli chcesz grupować elementy projektu do różnych funkcji, można dołączyć wiele plików .feature. Podczas tworzenia niestandardowego szablonu projektu programu SharePoint, zaleca się obejmują minimalne wymagane treści w każdym pliku .feature i skonfigurowanie funkcji za pomocą interfejsów API w Microsoft.VisualStudio.SharePoint.Features obszaru nazw do rozszerzenia, który jest skojarzony z szablonem projektu.Jeśli to zrobisz, Twój szablon projektu, jest on chroniony od przyszłych zmian struktury pliku .feature.Na przykład, który pokazuje, jak utworzyć plik .feature tylko minimalne wymagane zawartości, zobacz Instruktaż: Tworzenie elementu projektu kolumny witryny z szablonu projektu, część 1. Jeśli chcesz zmodyfikować plik .feature bezpośrednio, można sprawdzić zawartość za pomocą schematu % Program Files (11.0\Xml\Schemas\FeatureModelSchema.xsd x86)%\Microsoft programu Visual Studio.
featureName.Template.XML	Plik ten stanowi podstawę dla pliku manifestu funkcji (Feature.xml) dla każdej funkcji, która jest generowana na podstawie projektu.Jeśli chcesz określić niektóre zachowania, które nie ma być zmieniane przez użytkowników tego typu projektu, można dodać zawartość do tego pliku.Aby uzyskać więcej informacji, zobacz bloków konstrukcyjnych: funkcje i Feature.xml pliki. Podczas tworzenia pakietu rozwiązań z projektu programu Visual Studio scala zawartość każdej pary featureNameplik .feature i featureName.Template.XML plików w pliku manifestu funkcji.Aby uzyskać więcej informacji o tworzeniu pakiety rozwiązań, zobacz Jak: Tworzenie pakietu rozwiązanie programu SharePoint w programie Visual Studio.

Elementy projektu programu SharePoint

Może zawierać jeden lub więcej plików .spdata, które definiują typy elementów projektu programu SharePoint.Każdy plik .spdata musi mieć odpowiadający mu ISharePointProjectItemTypeProvider realizacji w zestawie rozszerzenia, który jest zawarty w pakiecie VSIX z szablonu projektu.Aby uzyskać więcej informacji, zobacz Tworzenie szablonów elementu.

Zazwyczaj projekty programu SharePoint zawierają co najmniej jeden element projektu programu SharePoint.Jednakże nie jest to wymagane.

featureName.feature

Ten plik definiuje funkcji programu SharePoint, który jest używany do grupowania kilka elementów projektu wdrażania.Podczas dostosowywania funkcji w projekcie za pomocą projektanta funkcji Visual Studio są przechowywane dane na temat funkcji w tym pliku.Jeśli chcesz grupować elementy projektu do różnych funkcji, można dołączyć wiele plików .feature.

Podczas tworzenia niestandardowego szablonu projektu programu SharePoint, zaleca się obejmują minimalne wymagane treści w każdym pliku .feature i skonfigurowanie funkcji za pomocą interfejsów API w Microsoft.VisualStudio.SharePoint.Features obszaru nazw do rozszerzenia, który jest skojarzony z szablonem projektu.Jeśli to zrobisz, Twój szablon projektu, jest on chroniony od przyszłych zmian struktury pliku .feature.Na przykład, który pokazuje, jak utworzyć plik .feature tylko minimalne wymagane zawartości, zobacz Instruktaż: Tworzenie elementu projektu kolumny witryny z szablonu projektu, część 1.

Jeśli chcesz zmodyfikować plik .feature bezpośrednio, można sprawdzić zawartość za pomocą schematu % Program Files (11.0\Xml\Schemas\FeatureModelSchema.xsd x86)%\Microsoft programu Visual Studio.

featureName.Template.XML

Plik ten stanowi podstawę dla pliku manifestu funkcji (Feature.xml) dla każdej funkcji, która jest generowana na podstawie projektu.Jeśli chcesz określić niektóre zachowania, które nie ma być zmieniane przez użytkowników tego typu projektu, można dodać zawartość do tego pliku.Aby uzyskać więcej informacji, zobacz bloków konstrukcyjnych: funkcje i Feature.xml pliki.

Podczas tworzenia pakietu rozwiązań z projektu programu Visual Studio scala zawartość każdej pary featureNameplik .feature i featureName.Template.XML plików w pliku manifestu funkcji.Aby uzyskać więcej informacji o tworzeniu pakiety rozwiązań, zobacz Jak: Tworzenie pakietu rozwiązanie programu SharePoint w programie Visual Studio.

Tworzenie kreatorów element szablonów i szablony projektu

Po zdefiniowaniu typu element projektu programu SharePoint i skojarzyć ją z szablonu elementu lub projektu, można również utworzyć kreatora.Kreator wyświetla programista używa szablonu elementu można dodać elementu projektu programu SharePoint do projektu lub gdy programista używa szablonu projektu do tworzenia nowego projektu, który zawiera element projektu programu SharePoint.Kreator może służyć do zbierania informacji od deweloperów i zainicjować nowy element projektu programu SharePoint.

Aby uzyskać opisy, które wskazują sposób tworzenia kreatorów, szablonów zapasów i szablonów projektu, zobacz Instruktaż: Tworzenie elementu projektu działania niestandardowe z szablonu elementu, część 2 i Instruktaż: Tworzenie elementu projektu kolumny witryny z szablonu projektu, część 2.