Demonstra Passo a passo: Adicionar os receptores de evento do recurso

  • Artigo

Receptores de evento do recurso são métodos que são executados quando ocorrer por um dos seguintes eventos relacionados ao recurso no SharePoint:

  • Um recurso é instalado.

  • Um recurso está ativado.

  • Um recurso está desativado.

  • Um recurso é removido.

Esta explicação passo a passo demonstra como adicionar um receptor de eventos para um recurso em um projeto do SharePoint. Ele demonstra as seguintes tarefas:

  • Criando um projeto vazio com um receptor de evento do recurso.

  • Manipulando o FeatureDeactivating método.

  • Usando o modelo de objeto de projeto do SharePoint para adicionar um anúncio para a lista de avisos.

ObservaçãoObservação

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Configurações do Visual Studio.

Pré-requisitos

Para completar este passo a passo, são necessários os seguintes componentes:

Criando um projeto de receptor de evento do recurso

Primeiro, crie um projeto para conter o receptor de evento do recurso.

Para criar um projeto com um receptor de evento do recurso

  1. Exibição de Novo projeto caixa de diálogo, apontando para novo na arquivo menu e, em seguida, selecionando Novo projeto.

  2. Expanda o SharePoint o nó em um Visual C# ou Visual Basice, em seguida, clique em 2010.

  3. No painel Templates, selecione Setup Project.

    Esse tipo de projeto é para receptores de evento do recurso porque não há nenhum modelo de projeto para eles.

  4. No nome digite FeatureEvtTest e clique em OK para exibir o O Assistente para personalização do SharePoint.

  5. Sobre o especificar o site e o nível de segurança de depuração de página, digite a URL do site do SharePoint server ao qual você deseja adicionar o novo item de campo personalizado ou usar o local padrão (http:// <system name> /).

  6. No o que é o nível de confiança para essa solução do SharePoint? seção, clique em Deploy como uma solução do farm e, em seguida, clique em Concluir.

    Para obter mais informações sobre as soluções em modo seguro em relação às soluções de farm, consulte Considerações sobre a solução no modo seguro.

Adicionando um receptor de eventos para o recurso.

Em seguida, adicionar um receptor de eventos para o recurso e adicionar o código que é executado quando o recurso está desativado.

Para adicionar um receptor de eventos para o recurso.

  1. Crie um recurso clicando com o botão direito no nó de recursos e selecionando Adicionar recurso.

    Observe que um recurso chamado Feature1 aparece sob o recursos nó.

  2. Adicionar um receptor de eventos para o recurso clicando com o Feature1 na recursos nó e selecionando Adicionar receptor de eventos.

    Isso adiciona um arquivo de código em Feature1. Nesse caso, ele é denominado Feature1.EventReceiver.cs ou Feature1.EventReceiver.vb, dependendo da linguagem de desenvolvimento do projeto.

  3. A classe do receptor de evento contém quatro métodos comentadas que atuam como eventos. Substituir o FeatureDeactivating método com o seguinte:

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

}

O receptor de evento do recurso de teste.

Em seguida, desativar o recurso para testar se a FeatureDeactivating método gera um anúncio à lista de anúncios do SharePoint.

Para testar o receptor de evento do recurso

  1. Definir o projeto Configuração de implantação Active propriedade para Sem ativação.

    A definição dessa propriedade impede que o recurso de ativação no SharePoint e lhe permite depurar os receptores de evento do recurso. Para obter mais informações, consulte Depuração de soluções do SharePoint.

  2. Pressione F5 para executar o projeto e implantá-lo no SharePoint.

  3. Na parte superior da página da Web do SharePoint, clique no Ações do Site botão e, em seguida, clique em Configurações do Site.

  4. Sob o Ações do Site seção a Configurações do Site página, clique no Gerenciar recursos do site link.

  5. No Recursos do Site página, clique no Activate botão ao lado do featureevttest feature1 recurso.

  6. No Recursos do Site página, clique no Deactivate botão ao lado do featureevttest feature1 recurso. Clique no link de confirmação para desativar o recurso.

  7. Clique o anúncios o link na barra de navegação.

    Observe que um anúncio é exibido na anúncios lista depois que o recurso está desativado.

Consulte também

Tarefas

Como: Criar um receptor de eventos

Outros recursos

Desenvolvimento de soluções do SharePoint