Sdílet prostřednictvím

Návod: Přidání příjemců událostí funkce

  • Článek

Příjemci událostí funkcí jsou metody, které se spouští, když se v SharePointu vyskytuje jedna z následujících událostí souvisejících s funkcemi:

  • Je nainstalována funkce.

  • Je aktivována funkce.

  • Funkce se deaktivuje.

  • Funkce se odebere.

Tento názorný postup ukazuje, jak přidat příjemce událostí do funkce v projektu SharePointu. Ukazuje následující úlohy:

  • Vytvoření prázdného projektu s příjemcem události funkce

  • Zpracování metody FeatureDeactivating

  • Pomocí objektového modelu projektu SharePointu přidáte oznámení do seznamu Oznámení.

    Poznámka:

    Váš počítač může v následujících pokynech zobrazovat odlišné názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace naleznete v tématu Přizpůsobení integrovaného vývojového prostředí (IDE).

Požadavky

K dokončení tohoto návodu budete potřebovat následující komponenty:

  • Podporované edice systému Microsoft Windows a SharePoint.

  • Visual Studio.

Vytvoření projektu příjemce události funkce

Nejprve vytvořte projekt, který bude obsahovat příjemce události funkce.

Vytvoření projektu s příjemcem události funkce

  1. Na řádku nabídek zvolte Soubor>nový>projekt, aby se zobrazilo dialogové okno Nový projekt.

  2. Rozbalte uzel SharePointu v sadě Visual C# nebo Visual Basic a zvolte uzel 2010.

  3. V podokně Šablony zvolte šablonu projektu SharePointu 2010.

    Tento typ projektu použijete pro příjemce událostí funkce, protože nemají žádnou šablonu projektu.

  4. Do pole Název zadejte FeatureEvtTest a pak kliknutím na tlačítko OK zobrazte Průvodce přizpůsobením sharepointu.

  5. Na stránce Zadat web a úroveň zabezpečení pro ladění zadejte adresu URL webu serveru SharePoint, do kterého chcete přidat novou položku vlastního pole, nebo použijte výchozí umístění (http://< název> systému/).

  6. V části Co je úroveň důvěryhodnosti pro toto řešení SharePointu? zvolte tlačítko Nasadit jako řešení farmy.

    Další informace ořešeních

  7. Zvolte tlačítko Dokončit a všimněte si, že pod uzlem Funkce se zobrazí funkce s názvem Feature1.

Přidání příjemce události do funkce

Dále do funkce přidejte příjemce události a přidejte kód, který se spustí při deaktivaci funkce.

Přidání příjemce události do funkce

  1. Otevřete místní nabídku pro uzel Funkce a potom zvolte Přidat funkci a vytvořte funkci.

  2. V uzlu Funkce otevřete místní nabídku funkce Feature1 a pak zvolte Přidat příjemce událostí a přidejte do této funkce příjemce události.

    Tím se přidá soubor kódu v části Feature1. V tomto případě se jmenuje Feature1.EventReceiver.cs nebo Feature1.EventReceiver.vb v závislosti na vývojovém jazyce vašeho projektu.

  3. Pokud je projekt napsaný v jazyce Visual C#, přidejte do horní části příjemce události následující kód, pokud tam ještě není:

    using System;

  4. Třída příjemce události obsahuje několik okomentovaných metod, které fungují jako události. Metodu FeatureDeactivating nahraďte následujícím kódem:

    public override void FeatureDeactivating(SPFeatureReceiverProperties properties)
{
    try
    {
        // Get reference to SharePoint site.
        SPSite site = new SPSite("http://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í přijímače událostí funkce

Dále deaktivujte funkci a otestujte, jestli metoda FeatureDeactivating vypíše oznámení do seznamu oznámení SharePointu.

Otestování příjemce události funkce

  1. Nastavte hodnotu vlastnosti Konfigurace aktivního nasazení projektu na hodnotu Bez aktivace.

    Nastavením této vlastnosti zabráníte funkci v aktivaci v SharePointu a umožníte ladit příjemce událostí funkce. Další informace najdete v tématu Ladění řešení SharePointu.

  2. Zvolte klávesu F5 , aby se projekt spustil, a nasaďte ho do SharePointu.

  3. V horní části webové stránky Služby SharePoint otevřete nabídku Akce webu a pak zvolte Nastavení Webu.

  4. V části Akce webu na stránce Web Nastavení zvolte odkaz Spravovat funkce webu.

  5. Na stránce Funkce zvolte tlačítko Aktivovat vedle funkce FeatureEvtTest Feature1.

  6. Na stránce Funkce zvolte tlačítko Deaktivovat vedle funkce FeatureEvtTest Feature1 a pak zvolte odkaz Deaktivovat tuto funkci pro potvrzení funkce.

  7. Zvolte tlačítko Domů.

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

Související obsah