Udostępnij za pośrednictwem

Instruktaż: Dodawanie funkcji zdarzenia odbiorników

  • Artykuł

Funkcja zdarzeń odbiorniki są metody, które wykonuje, jeśli występuje jeden z następujących zdarzeń związanych z funkcji programu SharePoint:

  • Funkcja jest zainstalowany.

  • Funkcja jest aktywna.

  • Funkcja jest dezaktywowany.

  • Funkcja jest usuwany.

W tym instruktażu przedstawiono sposób dodawania odbiorcy zdarzeń do funkcji w projekcie programu SharePoint.Ilustruje to następujące zadania:

  • Tworzenie pustego projektu z odbiornikiem zdarzeń funkcji.

  • Obsługa FeatureDeactivating metody.

  • Dodawanie anonsu do listy anonsów przy użyciu modelu obiektowego projektu programu SharePoint.

[!UWAGA]

Na danym komputerze mogą być używane inne nazwy lub lokalizacje pewnych elementów interfejsu użytkownika programu Visual Studio, które są używane w poniższych instrukcjach. Używana wersja programu Visual Studio oraz jej ustawienia określają te elementy. Aby uzyskać więcej informacji, zobacz Visual Studio, ustawienia.

Wymagania wstępne

Potrzebne do przeprowadzenia tego instruktażu następujące składniki:

Tworzenie projektu odbiorca zdarzeń funkcji

Najpierw utwórz projekt zawiera funkcji odbiorca zdarzeń.

Aby utworzyć projekt z odbiornikiem zdarzeń funkcji

  1. Na pasku menu wybierz pliku, Nowy, projektu do wyświetlania Nowy projekt okno dialogowe.

  2. Rozwiń SharePoint albo węzeł Visual C# lub programu Visual Basic, a następnie wybierz polecenie 2010 węzła.

  3. W szablonów okienku wybierz SharePoint 2010 projektu szablonu.

    Należy użyć tego typu projektu dla funkcji odbiorników, ponieważ mają one żadnego szablonu projektu.

  4. W Nazwa polu, wpisz FeatureEvtTest, a następnie wybierz OK przycisk, aby wyświetlić Kreator dostosowania programu SharePoint.

  5. Na Określ witrynę i poziom zabezpieczeń dla debugowania strony, wprowadź adres URL witryny serwera SharePoint, do którego chcesz dodać nowy element pola niestandardowe lub użyj domyślnej lokalizacji (http:// <system name> /).

  6. W Co to jest poziom zaufania dla tego rozwiązania programu SharePoint? sekcji, wybierz Wdroż jako roztwór farmy przycisku opcji.

    Więcej informacji o trybie piaskownicy rozwiązań kontra rozwiązań farmy, zobacz Względy roztwór trybie piaskownicy.

  7. Wybierz Zakończ przycisk i Zauważ, że funkcja o nazwie Feature1 pojawia się pod Funkcje węzła.

Dodawanie do funkcji odbiorca zdarzeń

Następnie dodać odbiorcy zdarzeń do funkcji i dodać kod wykonywany po zdezaktywowaniu funkcja.

Aby dodać do funkcji odbiorca zdarzeń

  1. Otwórz menu skrótów dla węzła funkcje i wybierz polecenie Dodać funkcję do utworzenia funkcji.

  2. Pod Funkcje węzła, otwórz menu skrótów dla Feature1, a następnie wybierz Dodać odbiorcy zdarzeń dodać odbiorcy zdarzeń do funkcji.

    Spowoduje to dodanie pliku kodu pod Feature1.W przypadku jej nazwie Feature1.EventReceiver.cs lub Feature1.EventReceiver.vb, w zależności od projektu języka programowania.

  3. Jeśli projekt został napisany w Visual C#, Dodaj następujący kod w górnej części odbiorca zdarzeń, jeśli go nie jest:

    using System;

  4. Klasa odbiorcy zdarzeń zawiera kilka metod komentarzem out, które działają jako zdarzenia.Zamień FeatureDeactivating metody z następujących czynności:

    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());
    }

}

Testowanie funkcji odbiorca zdarzeń

Dezaktywowanie dalej, aby przetestować funkcję czy FeatureDeactivating metody wyjścia anonsu do listy anonsów programu SharePoint.

Aby przetestować funkcji odbiorca zdarzeń

  1. Wartość projektu Konfiguracji wdrażania usługi Active właściwość, aby Nr aktywacji.

    Ustawienie tej właściwości uniemożliwia funkcja aktywacji programu SharePoint i umożliwia debugowanie funkcja odbiorników.Aby uzyskać więcej informacji, zobacz Debugowanie rozwiązań programu SharePoint.

  2. Wybierz F5 klawisz, aby uruchomić projekt i wdrażanie w programie SharePoint.

  3. W górnej części strony sieci Web programu SharePoint otwórz Akcje witryny menu, a następnie wybierz polecenie Ustawienia witryny.

  4. W obszarze Akcje witryny sekcji Ustawienia witryny wybierz Zarządzaj funkcjami witryny łącze.

  5. Na Funkcje wybierz Uaktywnij przycisk Dalej, aby FeatureEvtTest Feature1 funkcji.

  6. Na Funkcje wybierz Deactivate przycisk Dalej, aby FeatureEvtTest Feature1 funkcji, a następnie wybierz polecenie Dezaktywuj tę funkcję łącze potwierdzenia dezaktywować funkcję.

  7. Wybierz domu przycisku.

    Należy zauważyć, że ogłoszenie pojawia się w anonsów listę po zdezaktywowaniu funkcja.

Zobacz też

Zadania

Jak: tworzenie odbiorca zdarzeń

Inne zasoby

Tworzenie rozwiązań dla programu SharePoint