Passo a passo: Adicionar receptores de evento do recurso

Os destinatários de recurso são métodos que executam quando um dos seguintes eventos relacionados recurso ocorre no SharePoint:

Um recurso está instalado.
Um recurso está ativado.
Um recurso está desativado.
Um recurso é removido.

Essa explicação passo a passo demonstra como adicionar um receptor de evento como um recurso em um projeto do SharePoint.Demonstra as seguintes tarefas:

Criando um projeto vazio com um receptor de recurso.
Manipulando o método de FeatureDeactivating .
Usando o modelo de objeto de projeto do SharePoint para adicionar um comunicado à lista de anúncios.

Observaçã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 de Visual Studio.

Pré-requisitos

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

Edições suportadas do Microsoft Windows e do SharePoint.Para mais informações, consulte Requisitos para o desenvolvimento de soluções do SharePoint.
O Visual Studio.

Criando um projeto de receptor de recurso

Primeiro, crie um projeto conter o receptor de recurso.

Para criar um projeto com um receptor de recurso

Em a barra de menu, escolha Arquivo, Novo, Projeto para exibir a caixa de diálogo de Novo Projeto .
Expanda o nó de SharePoint em Visual C# ou Visual Basic, e então escolha o nó de 2010 .
Em o painel de Modelos , escolha o modelo de Projeto do SharePoint 2010 .

Você usa esse tipo de projeto para recipientes de recurso porque eles não têm qualquer modelo de projeto.
Em a caixa de Nome , entre em FeatureEvtTest, e então escolha o botão de OK para exibir Assistente de personalização do SharePoint.
Em a página de Especificar o site e o nível de segurança para depuração , digite o URL do site de servidor do SharePoint a qual você deseja adicionar o novo item personalizado de campo, ou use o local padrão (http:// <system name>).
Em a seção de Que é o nível de confiança para esta solução do SharePoint? , escolha o botão de opção de Implantar como uma solução de farm .

Para obter mais informações sobre as soluções na área restrita contra soluções de farm, consulte Considerações sobre a solução no modo seguro.
Escolha o botão de Concluir , e então observe que um recurso denominado Feature1 aparece sob o nó de Recursos .

Adicionando um receptor de evento para o recurso

Em seguida, adiciona um receptor de evento para o recurso e o código que executa quando o recurso é desativado.

Para adicionar um recurso ao receptor de evento

Abra o menu de atalho para o nó de recursos, e então escolha adicionar o recurso para criar um recurso.
Sob o nó de Recursos , abra o menu de atalho para Feature1, e então escolha Adicione o receptor de eventos para adicionar um evento ao receptor de recurso.

Isso adiciona um arquivo de código em Feature1.Em esse caso, é chamado Feature1.EventReceiver.cs ou Feature1.EventReceiver.vb, como sua linguagem de desenvolvimento de projeto.
Se seu projeto é escrito em Visual C#, adicione o seguinte código na parte superior do receptor de evento se não é abordado:
```
using System;
```

A classe de receptor de evento contém vários métodos comentados - out que atuam como eventos.Substituir o método de FeatureDeactivating 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());
    }

}

Testando o receptor de recurso

Em seguida, desativar o recurso para testar se a saída do método de um FeatureDeactivating comunicado a lista de anúncios o SharePoint.

Para testar o receptor de recurso

Defina o valor da propriedade de Configuração ativa de implantação de projeto a nenhuma ativação.

Definir essa propriedade impede que o recurso active no SharePoint e permite que você depurar destinatários de recurso.Para mais informações, consulte Depuração de soluções do SharePoint.
Escolha a chave de F5 para executar o projeto e para implementá-lo ao SharePoint.
Em a parte superior da página da Web do SharePoint, abra o menu de Localize ações , e então escolha Configurações de site.
Em a seção de Localize ações da página de Configurações de site , escolha o link de Gerenciar recursos do site .
Em a página de Recursos , escolha o botão de Ativar próximo ao recurso de FeatureEvtTest Feature1 .
Em a página de Recursos , escolha o botão de Desativar próximo ao recurso de FeatureEvtTest Feature1 , e então escolha o link de confirmação de Desativar esse recurso para desativar o recurso.
Escolha o botão de Início .

Observe que um comunicado aparece na lista de Anúncios depois que o recurso é desativado.

Consulte também

Tarefas

Como: criar um receptor de eventos

Outros recursos

Desenvolvimento de soluções do SharePoint

Last updated on 2013-02-25