Tworzenie części sieciowych dla SharePoint

Korzystając z części web, możesz bezpośrednio modyfikować zawartość, wygląd i zachowanie stron SharePoint w tej witrynie za pomocą przeglądarki.Części sieci Web to formanty strony serwera, które są uruchamiane wewnątrz witryny części sieci Web: są głównymi składnikami witryn, które wyświetlają się w witrynie SharePoint.Zobacz Kompilowanie bloków: składniki Web Part.

Możesz utworzyć i debugować części sieci w witrynie SharePoint używając szablonów z Visual Studio.

Tworzenie składnika Web Part w programie Visual Studio

Utwórz składnik web part, dodając Web Part element do każdego projektu programu SharePoint.Element wizualnego składnika Web Part może być użyty w ramach rozwiązań w trybie piaskownicy lub farmy.

Jeśli chcesz wizualnie zaprojektować składnik web part przy użyciu projektanta, utwórz projekt Wizualny składnik web part lub dodaj element Wizualny składnik web part do każdego projektu programu SharePoint.Element wizualnego składnika Web Part może być użyty tylko w ramach rozwiązania farmy.

Element składnika Web Part

Element Web Part zapewnia pliki, które służą do projektowania składnika web part witryny programu SharePoint..Kiedy dodajesz element Web Part, Visual Studio tworzy folder w Twoim projekcie, a następnie dodaje kilka plików do folderu.W poniższej tabeli opisano każdy typ pliku.

Plik

Opis

Elements.XML

Zawiera informacje, które używa plik definicji funkcji w projekcie, aby wdrożyć składnik web part.

plik .webpart

Oferuje informacje, które są potrzebne, aby program SharePoint wyświetlił składnik web part w galerii składników web part.

Kod pliku

Zawiera metody, które dodają formanty do składnika web part i które generują niestandardową zawartość wewnątrz składnika web part.

Aby uzyskać więcej informacji, zobacz Porady: tworzenie SharePoint Web Part.

Element wizualnego składnika Web Part

Program visual web part jest składnikiem web part, utworzonym przy użyciu funkcji Projektant Visual Web Developer w Visual Studio.Zobacz W Visual Studio 11 wersji Beta dla mapy zawartości sieci Web.

Program visual web part działa tak samo, jak inny składnikk web part.Aby dodać kontrolki, takie jak przyciski i okna tekstowe to części Web, dodaj kod do pliku XML.Możesz jednak dodać formanty wizualnych składników WebPart, przeciągając je lub kopiując do składnika WebPart z Przybornika programu Visual Studio.Projektant następnie generuje kod wymagany w pliku XML.Zobacz Porady: tworzenie części sieciowej SharePoint za pomocą narzędzia Projektant.

Formanty programu SharePoint

Visual Studio zapewnia kilka formantów do tworzenia witryn SharePoint, takich jak witryny aplikacji.Te kontrolki wyświetlają się w Oknie narzędzi pod kontrolkami SharePoint.Funkcja dla tych formantów wywodzi się z obszaru nazw Microsoft.SharePoint.WebControls , który zawiera formanty serwera ASP.NET, używane na stronach witryny i listy programu SharePoint.

Nazwa formantu

Opis

AspMenu

Wstawia menu ASP.Aby uzyskać więcej informacji, zobacz Omówienie menu formantów.

CssLink

Wstawia element LINK do strony .aspx i stosuje jeden lub więcej zewnętrznych arkuszy stylów zdefiniowanych przez CssRegistration.

DateTimeControl

Wstaw formant typu DataGodzina do strony .aspx.

FormDigest

Wstawia walidację bezpieczeństwa do strony .aspx.

ListProperty

Zwraca właściwość określonej listy.

ProjectProperty

Zwraca właściwość globalną bieżącej witryny sieci Web.

RssLink

Wstaw łącze czytnika kanałów RSS do strony .aspx.

ScriptLink

Oferuje właściwości i metody rejestracji zasobów, takie jak skrypty na stronie tak, że można ich żądać po wyrenderowaniu strony.

Motyw

Motyw jest stosowany do strony .aspx.

Debugowanie składnika Web Part

Możesz debugować projekt SharePoint, który zawiera część sieci, tak jak debuguje się inne projekty Visual Studio.Kiedy uruchamiasz debugger Visual Studio, Visual Studio otwiera witrynę SharePoint.

Aby zacząć debugować kod, dodaj web part do strony web part w SharePoint.

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

Ograniczenia wizualnego składnika Web Part

Rozpoczynając w programie Visual Studio, można dodać wizualne składniki sieci do uruchomionych w trybie piaskownicy rozwiązań programu SharePoint i rozwiązań farmy.Jednak wizualne składniki WebPart mają następujące ograniczenia:

  • Wizualne części sieci Web nie obsługują zastępowalnych parametrów.Aby uzyskać więcej informacji, zobacz Parametry wymienne.

  • Formanty użytkownika lub wizualne części sieci Web nie mogą być przeciągane i upuszczane lub kopiowane na wizualne części sieci Web.To działanie powoduje błąd kompilacji.

  • Wizualne części sieci Web nie obsługują bezpośrednio tokenów serwera SharePoint takich jak $SPUrl.Aby uzyskać więcej informacji, zobacz "Ograniczenia tokenu w składnikach Visual Web Parts w trybie Sandbox" w temacie Rozwiązywanie problemów z rozwiązaniami SharePoint.

  • Wizualne części sieci Web w rozwiązaniu w piaskownicy czasami wywołują błąd, „żądanie wykonania kodu w piaskownicy zostało odrzucone, ponieważ usługa hosta kodu w piaskownicy była zajęta i nie mogła obsłużyć Twojego żądania.” Aby uzyskać więcej informacji dotyczących tego błędu, zobacz ten post na blogu zespołu deweloperskiego SharePoint.

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

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

  • Debugowanie inline ASP.NET kod musi odbywać się w pliku wygenerowanego kodu, a nie w pliku znaczników.

  • Wizualne składniki sieci web nie obsługują korzystania z <@ Assembly Src= dyrektywy.

  • Formanty sieciowe programu SharePoint oraz niektóre formanty ASP.NET nie są obsługiwane w trybie piaskownicy środowiska programu SharePoint.Jeśli używane są nieobsługiwane regulatory na składniku Visual Web Part w rozwiązania w trybie piaskownicy, zostanie wyświetlony komunikat błędu „Typ lub nazwa przestrzeni nazw „Motyw” nie istnieje w przestrzeni nazwy „Microsoft.SharePoint.WebControls””.

Aby uzyskać więcej informacji dotyczących rozwiązań Sandbox, zobacz Różnice między rozwiązaniami w trybie piaskownicy oraz rozwiązaniami farmy.

Tworzenie składników Web Part starszego stylu w oparciu o program SharePoint

Możesz użyć szablonów z Visual Studio do tworzenia niestandardowych części sieci ASP.NET 2.0 dla SharePoint.ASP.NET 2.0 części sieci Web są skompilowane na infrastrukturze części sieci Web ASP.NET i są polecane dla nowych projektów.

W bardzo nielicznych przypadkach, być może trzeba utworzyć składnik sieci web przy użyciu starszego stylu składnika sieci web na bazie SharePoint.Można użyć programu Visual Studio do tworzenia tego typu części sieci, ale Visual Studio nie zapewnia żadnych szablonów, które zostały zaprojektowane specjalnie do pomocy w ich tworzeniu.

Aby uzyskać więcej informacji dotyczących tworzenia składnika WebPart opartego na starszym stylu SharePoint, zobacz Infrastruktura składnika WebPart w Windows SharePoint Services.Aby uzyskać więcej informacji dotyczących sposobu tworzenia składnika Web Part przy użyciu składnika WebPart opartego na starszym stylu SharePoint, zobacz Instruktaż tworzenia podstawowego składnika WebPart programu SharePoint.

Tematy pokrewne

Tytuł

Opis

Porady: tworzenie SharePoint Web Part

Pokazuje, w jaki sposób utworzyć składniki web Part dla stron programu SharePoint.

Porady: tworzenie części sieciowej SharePoint za pomocą narzędzia Projektant

Pokazuje, w jaki sposób utworzyć składniki web Part programu SharePoint przy użyciu powierzchni projektowej.

Porady: tworzenie formantu użytkownika dla części sieciowej lub strony aplikacji SharePoint

Pokazuje, w jaki sposób utworzyć niestandardowe formanty wielokrotnego użytku, które mogą być wykorzystane przez strony aplikacji i składniki web Part, które są uruchamiane w programie SharePoint.

Wskazówki: tworzenie części sieciowej dla SharePoint

Opisuje sposób projektowania składnika web part programu SharePoint.

Wskazówki: tworzenie składnika Web part dla SharePoint za pomocą Projektanta

Opisuje sposób projektowania składnika web part programu SharePoint, przeciągając formanty do powierzchni projektu visual.

Wskazówki: Tworzenie składnika Web Part programu Silverlight wyświetlającego dane OData dla programu SharePoint

Opisuje sposób projektowania składnika web part programu SharePoint, który obsługuje aplikację Silverlight i wyświetla dane z list programu SharePoint.

Praca z Visual Web Developer

Zawiera opis sposobu korzystania z projektanta, który pojawia się po otwarciu strony sieci Web w projekcie.