Udostępnij za pośrednictwem


Tworzenie składników Web Part dla programu SharePoint

Za pomocą składników Web Part można modyfikować zawartość, wygląd i zachowanie stron witryny programu SharePoint przy użyciu przeglądarki. Składniki Web Part to kontrolki po stronie serwera uruchamiane wewnątrz strony składników Web Part: są to bloki konstrukcyjne stron, które są wyświetlane w witrynie programu SharePoint. Zobacz Blok konstrukcyjny: składniki Web Part.

Składniki Web Part można tworzyć i debugować w witrynie programu SharePoint przy użyciu szablonów z programu Visual Studio.

Tworzenie składnika Web Part w programie Visual Studio

Utwórz składnik Web Part, dodając element składnika Web Part do dowolnego projektu programu SharePoint. Element składnika Web Part można użyć w rozwiązaniu w trybie piaskownicy lub w rozwiązaniu farmy.

Jeśli chcesz wizualnie zaprojektować składnik Web Part przy użyciu projektanta, utwórz projekt składnika Web Part visual web part lub dodaj element składnika Visual Web Part do dowolnego projektu programu SharePoint. Element składnika Web Part wizualizacji można używać tylko w rozwiązaniu farmy.

Element składnika Web Part

Element składnika Web Part zawiera pliki, których można użyć do projektowania składnika Web Part dla witryny programu SharePoint. Po dodaniu elementu składnika Web Part program Visual Studio tworzy folder w projekcie, a następnie dodaje kilka plików do folderu. W poniższej tabeli opisano każdy plik.

Plik opis
Elements.xml Zawiera informacje używane przez plik definicji funkcji w projekcie do wdrożenia składnika Web Part.
Plik .webpart Zawiera informacje, które program SharePoint musi wyświetlać składnik Web Part w galerii składników Web Part.
Plik kodu Zawiera metody, które dodają kontrolki do składnika Web Part i generują zawartość niestandardową w składniku Web Part.

Aby uzyskać więcej informacji, zobacz How to: Create a SharePoint Web Part (Instrukcje: tworzenie składnika Web Part programu SharePoint).

Element składnika Web Part wizualizacji

Składnik Web Part wizualizacji to składnik Web Part tworzony przy użyciu projektanta visual web developer w programie Visual Studio. Składnik Web Part wizualizacji działa tak samo jak każdy inny składnik Web Part. Aby dodać kontrolki, takie jak przyciski i pola tekstowe, do składnika Web Part, należy dodać kod do pliku XML. Do składnika Web Part można jednak dodawać kontrolki do wizualnego składnika Web Part, przeciągając je lub kopiując do składnika Web Part z przybornika programu Visual Studio. Następnie projektant generuje wymagany kod w pliku XML. Zobacz Instrukcje: tworzenie składnika Web Part programu SharePoint przy użyciu projektanta.

Kontrolki programu SharePoint

Program Visual Studio udostępnia pewne kontrolki do tworzenia stron programu SharePoint, takich jak strony aplikacji. Te kontrolki są wyświetlane w przyborniku w obszarze Kontrolki programu SharePoint. Funkcje tych kontrolek pochodzą z przestrzeni nazw Microsoft.SharePoint.WebControls , która zawiera ASP.NET kontrolki serwera używane na stronach witryny programu SharePoint i listy.

Nazwa kontrolki opis
AspMenu Wstawia menu ASP. Aby uzyskać więcej informacji, zobacz Kontrolka menu — omówienie.
CssLink Wstawia element LINK do strony aspx i stosuje jeden lub więcej zewnętrznych arkuszy stylów zdefiniowanych przez funkcję CssRegistration.
DateTimeControl Wstawia kontrolkę DateTime do strony aspx .
FormDigest Wstawia walidację zabezpieczeń do strony aspx
ListaWłaściwość Zwraca właściwość określonej listy.
Właściwość projektu Zwraca właściwość globalną bieżącej witryny internetowej.
RssLink Wstawia link do kanału informacyjnego RSS na stronie aspx .
ScriptLink Udostępnia właściwości i metody rejestrowania zasobów, takich jak skrypty, na stronie, aby można było zażądać ich po renderowaniu strony.
Motyw Stosuje motyw do strony aspx .

Debugowanie składnika Web Part

Możesz debugować projekt programu SharePoint zawierający składnik Web Part tak samo jak w przypadku debugowania innych projektów programu Visual Studio. Po uruchomieniu debugera programu Visual Studio program Visual Studio otwiera witrynę programu SharePoint.

Aby rozpocząć debugowanie kodu, dodaj składnik Web Part do strony składników Web Part w programie SharePoint.

Aby uzyskać więcej informacji na temat debugowania projektów programu SharePoint, zobacz Rozwiązywanie problemów z rozwiązaniami programu SharePoint.

Ograniczenia składników Web Part wizualizacji

Począwszy od programu Visual Studio, można dodawać składniki Web Part w trybie piaskownicy do rozwiązań programu SharePoint i rozwiązań farmy. Jednak składniki Web Part wizualizacji mają następujące ograniczenia:

  • Składniki Web Part wizualizacji nie obsługują parametrów możliwych do zastąpienia. Aby uzyskać więcej informacji, zobacz Zastępowalne parametry.

  • Nie można przeciągać ani kopiować kontrolek użytkownika ani składników Web Part wizualizacji ani kopiować ich do wizualnych składników Web Part. Ta akcja powoduje błąd kompilacji.

  • Składniki Web Part wizualizacji nie obsługują bezpośrednio tokenów serwera programu SharePoint, takich jak $SPUrl. Aby uzyskać więcej informacji, zobacz "Ograniczenia tokenu w wizualizacji w trybie piaskownicy składniki Web Part" w temacie Rozwiązywanie problemów z rozwiązaniami programu SharePoint.

  • Składniki Web Part wizualizacji w rozwiązaniu w trybie piaskownicy czasami otrzymują błąd "Żądanie wykonania kodu w trybie piaskownicy zostało odrzucone, ponieważ usługa hosta kodu w trybie piaskownicy była zbyt zajęta, aby obsłużyć żądanie". Aby uzyskać więcej informacji na temat tego błędu, zobacz ten wpis w blogu zespołu deweloperów programu SharePoint.

  • Debugowanie języka JavaScript po stronie serwera nie jest obsługiwane w programie Visual Studio, ale obsługiwane jest debugowanie języka JavaScript po stronie klienta.

    Chociaż można dodać wbudowany kod JavaScript do pliku znaczników po stronie serwera, debugowanie nie jest obsługiwane w przypadku punktów przerwania dodanych do znaczników. Aby debugować kod JavaScript, odwołaj się do zewnętrznego pliku JavaScript w pliku znaczników, a następnie ustaw punkty przerwania w pliku JavaScript.

  • Debugowanie wbudowanego kodu ASP.NET należy wykonać w wygenerowanych plikach kodu zamiast w pliku znaczników.

  • Składniki Web Part wizualizacji <@ Assembly Src= nie obsługują stosowania dyrektywy.

  • Kontrolki sieci Web programu SharePoint i niektóre kontrolki ASP.NET nie są obsługiwane w środowisku piaskownicy programu SharePoint. Jeśli nieobsługiwane kontrolki są używane w składniku Web Part wizualizacji w rozwiązaniu w trybie piaskownicy, zostanie wyświetlony błąd "Nazwa typu lub przestrzeni nazw "Motyw" nie istnieje w przestrzeni nazw "Microsoft.SharePoint.WebControls".

    Aby uzyskać więcej informacji na temat rozwiązań w trybie piaskownicy, zobacz Różnice między rozwiązaniami w trybie piaskownicy i farmy.

Tworzenie starszych składników Web Part opartych na programie SharePoint

Szablony w programie Visual Studio umożliwiają tworzenie niestandardowych składników Web Part ASP.NET 2.0 dla programu SharePoint. składniki Web Part ASP.NET 2.0 są oparte na infrastrukturze składników Web Part ASP.NET i są zalecanym typem dla nowych projektów.

W bardzo niewielu przypadkach może być konieczne utworzenie składnika Web Part przy użyciu starszego stylu składnika Web Part opartego na programie SharePoint. Za pomocą programu Visual Studio można tworzyć te typy składników Web Part, ale program Visual Studio nie udostępnia żadnych szablonów zaprojektowanych specjalnie w celu ich utworzenia.

Aby uzyskać więcej informacji na temat tworzenia starszego stylu składnika Web Part opartego na programie SharePoint, zobacz Web Part Infrastructure in Windows SharePoint Services (Infrastruktura składników Web Part w usługach Windows SharePoint Services). Aby uzyskać więcej informacji na temat tworzenia składnika Web Part przy użyciu starszego stylu składnika Web Part opartego na programie SharePoint, zobacz Przewodnik tworzenia podstawowego składnika Web Part programu SharePoint.

Nazwa opis
Instrukcje: tworzenie składnika Web Part programu SharePoint Przedstawia sposób tworzenia składników Web Part dla stron programu SharePoint.
Instrukcje: tworzenie składnika Web Part programu SharePoint przy użyciu projektanta Przedstawia sposób tworzenia składników Web Part dla programu SharePoint przy użyciu powierzchni projektowej wizualizacji.
Instrukcje: tworzenie kontrolki użytkownika dla strony aplikacji programu SharePoint lub składnika Web Part Przedstawia sposób tworzenia niestandardowych kontrolek wielokrotnego użytku, które mogą być używane przez strony aplikacji i składniki Web Part uruchamiane w programie SharePoint.
Przewodnik: tworzenie składnika Web Part dla programu SharePoint Opisuje sposób projektowania składnika Web Part dla programu SharePoint.
Przewodnik: tworzenie składnika Web Part dla programu SharePoint przy użyciu projektanta Opisuje sposób projektowania składnika Web Part dla programu SharePoint przez przeciąganie kontrolek do powierzchni projektowej wizualizacji.
Przewodnik: tworzenie składnika Web Part silverlight, który wyświetla OData dla programu SharePoint Opisuje sposób projektowania składnika Web Part dla programu SharePoint, który hostuje aplikację Silverlight i wyświetla dane z list programu SharePoint.