Podawanie informacji o pakowaniu i wdrażaniu w elementach projektu
Wszystkie elementy projektu programu SharePoint w programie Visual Studio mają właściwości, których można użyć do dostarczania dodatkowych danych podczas wdrażania projektu w programie SharePoint. Właściwości są następujące:
Właściwości funkcji
Odbiorniki funkcji
Odwołania do danych wyjściowych projektu
wpisy kontrolek Sejf
Te właściwości są wyświetlane w oknie Właściwości .
Właściwości funkcji
Użyj właściwości Właściwości funkcji, aby określić dane używane przez funkcję. Dane właściwości funkcji to zestaw wartości (przechowywanych jako pary klucz/wartość), który jest dołączony do funkcji podczas wdrażania w programie SharePoint. Po wdrożeniu funkcji można uzyskać dostęp do wartości właściwości w kodzie.
Po dodaniu wartości właściwości funkcji do elementu projektu wartość jest dodawana jako element w manifeście funkcji elementu. W projekcie modelu Połączenie ivity (BDC) danych biznesowych, na przykład właściwość funkcji ModelFileName jest wyświetlana jako:
<Property Key="ModelFileName" Value="BdcModel1\BdcModel1.bdcm" />
Po ustawieniu wartości właściwości funkcji zostanie ona dodana jako element FeatureProperty w pliku spdata projektu. Aby uzyskać informacje na temat uzyskiwania dostępu do właściwości w programie SharePoint, zobacz Klasa SPFeaturePropertyCollection.
Identyczne wartości właściwości funkcji ze wszystkich elementów projektu są scalane razem w manifeście funkcji. Jeśli jednak dwa różne elementy projektu określą ten sam klucz właściwości funkcji z wartościami niezgodnymi, wystąpi błąd walidacji.
Aby dodać właściwości funkcji bezpośrednio do pliku funkcji (.feature), wywołaj metodę Addmodelu obiektów programu Visual Studio SharePoint . Jeśli używasz tej metody, należy pamiętać, że ta sama reguła dotycząca dodawania identycznych wartości właściwości funkcji we właściwościach funkcji ma również zastosowanie do właściwości dodanych bezpośrednio do pliku funkcji.
Odbiornik funkcji
Odbiorniki funkcji to kod wykonywany w przypadku wystąpienia niektórych zdarzeń do funkcji zawierającej element projektu. Można na przykład zdefiniować odbiorniki funkcji, które są wykonywane po zainstalowaniu, aktywowaniu lub uaktualnieniu funkcji. Jednym ze sposobów dodania odbiornika funkcji jest dodanie go bezpośrednio do funkcji zgodnie z opisem w temacie Przewodnik: Dodawanie odbiorników zdarzeń funkcji. Innym sposobem jest odwołanie do nazwy klasy odbiornika funkcji i zestawu we właściwości Odbiornik funkcji.
Metoda bezpośrednia
Po bezpośrednim dodaniu odbiornika funkcji do funkcji plik kodu jest umieszczany w węźle Funkcja w Eksplorator rozwiązań. Podczas kompilowania rozwiązania programu SharePoint kod kompiluje się w zestawie i wdraża go w programie SharePoint. Domyślnie właściwości funkcji Zestaw odbiorcy i Klasa odbiorcy odwołują się do nazwy klasy i zestawu.
reference — Metoda
Innym sposobem dodania odbiornika funkcji jest użycie właściwości Feature Receiver elementu projektu w celu odwołania się do zestawu odbiornika funkcji. Wartość właściwości Odbiornik funkcji ma dwie podwłaściwości: Assembly (Zestaw ) i Class Name (Nazwa klasy). Zestaw musi używać w pełni kwalifikowanej, "silnej" nazwy, a nazwa klasy musi być pełną nazwą typu. Aby uzyskać więcej informacji, zobacz Zestawy o silnych nazwach. Po wdrożeniu rozwiązania w programie SharePoint funkcja używa przywołytowanego odbiornika funkcji do obsługi zdarzeń funkcji.
W czasie kompilacji rozwiązania wartości właściwości odbiornika funkcji w funkcji i jej projektach są scalane w celu ustawienia atrybutów ReceiverAssembly i ReceiverClass elementu Feature w manifeście funkcji pliku rozwiązania programu SharePoint (.wsp). W związku z tym, jeśli wartości właściwości Assembly i Class Name elementu projektu i funkcji są określone, wartości właściwości elementu projektu i funkcji muszą być zgodne. Jeśli wartości nie są zgodne, zostanie wyświetlony błąd weryfikacji. Jeśli chcesz, aby element projektu odwołył się do zestawu odbiornika funkcji innego niż używany przez tę funkcję, przenieś go do innej funkcji.
Jeśli odwołujesz się do zestawu odbiornika funkcji, który nie jest jeszcze na serwerze, musisz również dołączyć plik zestawu do pakietu; Program Visual Studio nie dodaje go za Ciebie. Podczas wdrażania funkcji plik zestawu jest kopiowany do globalnej pamięci podręcznej zestawów systemu (GAC) lub folderu Bin w katalogu fizycznym programu SharePoint. Aby uzyskać więcej informacji, zobacz instrukcje: Dodawanie i usuwanie dodatkowych zestawów.
Aby uzyskać więcej informacji na temat odbiorników funkcji, zobacz Feature Event Receiver and Feature Events (Odbiornik zdarzeń funkcji i zdarzenia funkcji).
Odwołania do danych wyjściowych projektu
Właściwość Odwołania wyjściowe projektu określa zależność, taką jak zestaw, który musi zostać uruchomiony przez element projektu. Załóżmy na przykład, że twoje rozwiązanie ma projekt usługi BDC i projekt klasy. Jeśli projekt usługi BDC ma zależność od zestawu, który jest wynikiem projektu klasy, możesz odwołać się do zestawu we właściwości Odwołania wyjściowe projektu BDC. Gdy projekt usługi BDC jest spakowany, zestaw zależny jest uwzględniony w pakiecie.
Odwołania do danych wyjściowych projektu są zwykle zestawami, ale w niektórych przypadkach (np. projekty Silverlight) mogą być innymi typami plików.
Aby uzyskać więcej informacji, zobacz How to: Add a project output reference (Instrukcje: dodawanie odwołania do danych wyjściowych projektu).
wpisy kontrolek Sejf
Program SharePoint udostępnia mechanizm zabezpieczeń nazywany wpisami bezpiecznej kontroli, aby ograniczyć dostęp niezaufanych użytkowników do niektórych mechanizmów kontroli. Zgodnie z projektem program SharePoint umożliwia niezaufanym użytkownikom przekazywanie i tworzenie stron ASPX na serwerze programu SharePoint. Aby uniemożliwić tym użytkownikom dodawanie niebezpiecznego kodu do stron ASPX, program SharePoint ogranicza dostęp do bezpiecznych kontrolek. Sejf kontrolki to kontrolki ASPX i składniki Web Part wyznaczone jako bezpieczne i mogą być używane przez dowolnego użytkownika w witrynie. Aby uzyskać więcej informacji, zobacz Krok 4: Dodawanie składnika Web Part do listy kontrolek Sejf.
Każdy element projektu programu SharePoint w programie Visual Studio ma właściwość o nazwie Sejf Wpisy kontrolek, które mają dwie właściwości podrzędne wartości logicznej: Sejf i Sejf Względem skryptu. Właściwość Sejf określa, czy niezaufani użytkownicy mogą uzyskiwać dostęp do kontroli. Właściwość Sejf Against Script określa, czy niezaufani użytkownicy mogą wyświetlać i zmieniać właściwości kontrolki.
Sejf wpisy kontrolek są przywołyne na podstawie zestawu. Do zestawu projektu można dodawać bezpieczne wpisy sterujące, wprowadzając je we właściwości Sejf wpisów kontrolnych elementu projektu. Można jednak również dodać bezpieczne wpisy kontroli do zestawu projektu za pomocą karty Zaawansowane w Projektant pakietu podczas dodawania dodatkowego zestawu do pakietu. Aby uzyskać więcej informacji, zobacz Jak oznaczyć kontrolki jako bezpieczne kontrolki lub Rejestrowanie zestawu składników Web Part jako kontrolkę Sejf.
Wpisy XML dla bezpiecznych kontrolek
Po dodaniu bezpiecznego wpisu kontrolki do elementu projektu lub do zestawu projektu odwołanie jest zapisywane w manifeście pakietu w następującym formacie:
<Assemblies>
<Assembly Location="<assembly name>.dll"
DeploymentTarget="<'GlobalAssemblyCache' or 'WebApplication'">>
<SafeControls>
<SafeControl Assembly="<assembly name>.dll" Namespace=
"<SharePoint project name>" Safe="<true/false>"
TypeName="<control name>"
SafeAgainstScript="<true/false>" />
</SafeControls>
</Assembly>
</Assemblies>