Criar um manipulador de eventos básica

O seguinte exemplo mostra as etapas básicas de criar um manipulador de eventos que executa codificar antes uma item da lista é excluído ou depois que um item é adicionado. O exemplo funciona em listas de anúncio, adicionando texto para o corpo de novos itens, mas cancelando tenta excluir itens existentes.

Você cria um assembly manipulador de eventos em Microsoft Visual Studio 2005 criando um biblioteca de classes. Você adicionar a referência Microsoft.SharePoint.dll e herdam a classe base Microsoft.SharePoint.SPItemEventReceiver T:Microsoft.SharePoint.SPItemEventReceiver, conforme o seguinte exemplo.

                  using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint;

namespace MyEventHandlers

{
    public class SimpleEventHandler : SPItemEventReceiver
    {
    }
}

Windows SharePoint Services 3.0 instancia um objeto de sua classe quando ocorrer ações dentro de lista. Como um desenvolvedor, você substituir os métodos de classe base o SharePoint para os eventos você estiver interessado em manipulação. Os métodos do SPItemEventReceiver classe que você pode substituir são o seguinte:

• ContextEvent

• ItemAdded

• ItemAdding

• ItemAttachmentAdded

• ItemAttachmentAdding

• ItemAttachmentDeleted

• ItemAttachmentDeleting

• ItemCheckedIn

• ItemCheckedOut

• ItemCheckingIn

• ItemCheckingOut

• ItemDeleted

• ItemDeleting

• ItemFileConverted

• ItemFileMoved

• ItemFileMoving

• ItemUncheckedOut

• ItemUncheckingOut

• ItemUpdated

• ItemUpdating

O exemplo substitui os dois métodos: ItemDeleting e ItemAdded. Lembre-se que o sufixo "vel" indica que nós são manipulação o evento em um síncrono maneira antes de realmente ocorre a ação e o sufixo "Ed" indica que estamos manipulação de evento em um assíncrono maneira após a ação.

                  public override void ItemDeleting(SPItemEventProperties properties)
{
    properties.Cancel = true;
    properties.ErrorMessage = "Deleting is not supported.";
}

Você tem acessar para os dados associado com o objeto SPListItem T:Microsoft.SharePoint.SPListItem por um objeto que é fornecido como um parâmetro de entrada quando o método for chamado. Este objeto é do tipo SPItemEventProperties. Por meio de Cancel P:Microsoft.SharePoint.SPItemEventProperties.Cancel propriedade do SPItemEventProperties T:Microsoft.SharePoint.SPItemEventProperties classe você pode cancelar o evento e através de ErrorMessage P:Microsoft.SharePoint.SPItemEventProperties.ErrorMessage propriedade você pode exibir um personalizado mensagem de erro em uma página SharePoint.

O segundo método para substituir é ItemAdded. O seguinte exemplo usa o ListItem P:Microsoft.SharePoint.SPItemEventProperties.ListItem propriedade para retornar um objeto que representa o novo item da lista e modifica o texto do item.

                  public override void ItemAdded(SPItemEventProperties properties)
{
    SPListItem oItem = properties.ListItem;
    oItem["Body"] = "Body text maintained by the system.";
    oItem.Update();
}

Você deve registrar o ItemDeleting e receptores evento ItemAdded ItemAdded como descritos na Registrar um manipulador de eventos.

Consulte também

Tarefas

Como a: criar um recurso do manipulador de eventos

Conceitos

Registrar um manipulador de eventos
Registros de eventos
Guia de Introdução Com programaticamente personalizar uma Web Site SharePoint em Visual Studio
A validação de segurança e fazer postagens para atualizar os dados
Elevação de privilégio
Trabalhando com recursos