Názorný postup: Přidání funkce přijímačů událostí

Funkce přijímačů událostí jsou metody, které při jedné z následujících událostí související funkce služby SharePoint:

• Instalace součásti.

• Je aktivována funkce.

• Funkce je deaktivován.

• Funkce bude odebrána.

Tento návod ukazuje, jak přidat příjemce události funkce v projektu aplikace SharePoint.Ukazuje následující úkoly:

• Vytvoření prázdného projektu s přijímač události funkce.

• Zpracování FeatureDeactivating metoda.

• Použití objektového modelu služby SharePoint projektu přidat do seznamu oznámení oznámení.

[!POZNÁMKA]

Ve vašem počítači se pro některé z prvků uživatelského rozhraní sady Visual Studio mohou zobrazit jiné názvy a umístění, než jsou uvedeny v následujících pokynech. Tyto prvky jsou určeny verzí aplikace Visual Studio a použitým nastavením. Další informace naleznete v tématu Nastavení aplikace Visual Studio.

Požadavky

Chcete-li dokončit tento návod, potřebujete následující komponenty:

• Podporované edice systému Windows a serveru SharePoint.Další informace naleznete v tématu Požadavky na vývoj řešení služby SharePoint.

• Visual Studio.

Vytvoření projektu přijímače události funkce

Nejprve vytvořte projekt obsahovat funkci příjemce událostí.

Vytvoření projektu pomocí funkce příjemce událostí

1. V řádku nabídek zvolte soubor, Nový, projektu zobrazení Nový projekt dialogové okno.

2. Rozbalte SharePoint buď uzlu Visual C# nebo jazyka Visual Basica pak zvolte 2010 uzel.

3. V šablony podokně zvolte SharePoint 2010 projektu šablony.

   Tento typ projektu pro funkce přijímačů událostí použít, protože nemají žádná šablona projektu.

4. V název pole, zadejte FeatureEvtTest a potom zvolte OK na tlačítko Průvodce vlastním nastavením aplikace SharePoint.

5. Na určení webu a úroveň zabezpečení pro ladění stránku, zadejte adresu URL webu služby SharePoint server, ke kterému chcete přidat novou položku Vlastní pole nebo použít výchozí umístění (http:// <system name> /).

6. V Co je úroveň důvěryhodnosti pro toto řešení SharePoint? bodu, zvolte nasadit jako řešení farmy přepínač.

   Další informace o uzavřených apletů řešení oproti řešení farmy naleznete v Uzavřených apletů aspekty řešení.

7. Zvolte Dokončit tlačítko a povšimněte si Feature1 s názvem funkce se zobrazí pod funkce uzel.

Přidání funkce přijímače událostí

Dále přidejte přijímače události funkce a kód, který provede při deaktivaci funkce.

Přidat příjemce události funkce

1. Otevřete místní nabídku pro funkce uzlu a pak zvolte Přidat funkci vytvořit funkci.

2. Pod funkce uzel, otevřete místní nabídku pro Feature1a pak zvolte Přidat příjemce událostí funkci Přidat příjemce události.

   Přidá kód souboru pod Feature1.V tomto případě je pojmenován Feature1.EventReceiver.cs nebo Feature1.EventReceiver.vb, podle projektu vývoj jazyka.

3. Pokud projekt Visual C#, pokud ještě není, v horní části přijímače události přidejte následující kód:

   using System;
   

4. Třída příjemce událostí obsahuje několik metod s komentářem out jako události.Nahradit FeatureDeactivating s následující metody:

   Public Overrides Sub FeatureDeactivating(ByVal properties As SPFeatureReceiverProperties)
       Try
           ' Get reference to SharePoint site.
           Dim site As SPSite = New SPSite("https://localhost")
           Dim web As SPWeb = site.OpenWeb("/")
           ' Get reference to Announcements list.
           Dim announcementsList As SPList = web.Lists("Announcements")
           ' Add new announcement to Announcements list.
           Dim oListItem As SPListItem = announcementsList.Items.Add
           oListItem("Title") = ("Deactivated Feature: " + properties.Definition.DisplayName)
           oListItem("Body") = (properties.Definition.DisplayName + (" was deactivated on: " + DateTime.Now.ToString))
           oListItem.Update()
       Catch e As Exception
           Console.WriteLine(("Error: " + e.ToString))
       End Try
   End Sub
   

   public override void FeatureDeactivating(SPFeatureReceiverProperties properties)
   {
       try
       {
           // Get reference to SharePoint site.
           SPSite site = new SPSite("https://localhost");
           SPWeb web = site.OpenWeb("/");
           // Get reference to Announcements list.
           SPList announcementsList = web.Lists["Announcements"];
   
           // Add new announcement to Announcements list.
           SPListItem oListItem = announcementsList.Items.Add();
           oListItem["Title"] = "Deactivated Feature: " + properties.Definition.DisplayName;
           oListItem["Body"] = properties.Definition.DisplayName + " was deactivated on: " + DateTime.Now.ToString();
           oListItem.Update();
   
       }
   
       catch (Exception e)
       {
           Console.WriteLine("Error: " + e.ToString());
       }
   
   }
   

Testování funkce přijímače události

Dále deaktivovat funkci otestovat zda FeatureDeactivating metoda výstupy oznámení seznamu oznámení služby SharePoint.

Testování funkce přijímače události

1. Nastavte hodnotu projektu Konfigurace nasazení služby Active vlastnost Aktivace Č.

   Nastavení této vlastnosti funkce brání aktivace služby SharePoint a umožňuje ladění funkce přijímačů událostí.Další informace naleznete v tématu Ladění řešení služby SharePoint.

2. Zvolte F5 klíč spuštění projektu a nasazení do služby SharePoint.

3. V horní části webu služby SharePoint otevřete Akce webu nabídce a pak zvolte Nastavení webu.

4. Pod Akce webu část Nastavení webu zvolte funkce webu Správa odkaz.

5. Na funkce zvolte aktivovat vedle tlačítka FeatureEvtTest Feature1 funkce.

6. Na funkce zvolte Deaktivovat vedle tlačítka FeatureEvtTest Feature1 funkce a pak zvolte Deaktivovat tuto funkci odkaz potvrzení deaktivovat funkci.

7. Zvolte Home tlačítko.

   Všimněte si, že oznámení se zobrazí v oznámení seznam po deaktivaci funkce.

Viz také

Úkoly

Jak: vytvoření příjemce událostí

Další zdroje

Vývoj řešení služby SharePoint