Enlace de controladores de eventos mediante el archivo Features.xml de SharePoint

Artículo
09/24/2014

Última modificación: viernes, 09 de abril de 2010

Hace referencia a: SharePoint Foundation 2010

Puede definir controladores de eventos para un tipo de contenido específico de Microsoft SharePoint Foundation 2010 mediante el uso de una característica de SharePoint. Por ejemplo, puede definir el tipo de contenido denominado "Cliente" y, en la definición del comportamiento del cliente, puede definir los metadatos para el controlador de eventos asociado.

Uso de características de SharePoint

Los tipos de contenido se definen mediante una característica de SharePoint. Cuando se define un tipo de contenido con una característica, se crean dos archivos XML, tal como se describe a continuación:

Feature.xml Este archivo XML se usa para definir los metadatos de la nueva característica. El ejemplo de código siguiente establece el ámbito de la función en el nivel del sitio y define un identificador único para la nueva característica. A continuación, a través del elemento ElementManifests, elige la ubicación del segundo archivo XML que almacena toda la información detallada acerca de la característica.
```
<?xml version="1.0" encoding="utf-8"?>
<Feature Scope="Web" 
  Title="Simple Event Handler Registration" 
  Id="A6B8687A-3200-4b01-AD76-09E8D163FB9A" 
  xmlns="https://schemas.microsoft.com/sharepoint/">
  <ElementManifests>
    <ElementManifest Location="elements.xml"/>
  </ElementManifests>
</Feature>
```

Elements.xml Este archivo se usa para definir el ensamblado que encapsula el controlador de eventos, la clase en sí y, además, un número de secuencia que especifica el orden, si hay varios controladores de eventos asociados con la característica. En el ejemplo siguiente se muestra cómo enlazar un receptor de eventos que responda a los eventos de eliminación y adición de elementos de lista.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <Receivers ListTemplateId="104">
    <Receiver>
      <Name>MyEventHandlers</Name>
      <Type>ItemDeleting</Type>
      <SequenceNumber>10000</SequenceNumber>
      <Assembly>MyEventHandlers, Version=1.0.0.0, Culture=neutral, PublicKeyToken=4358f2a5344ff0dc</Assembly>
      <Class>MyEventHandlers.SimpleEventHandler</Class>
      <Data></Data>
      <Filter></Filter>
    </Receiver>
    <Receiver>
      <Name>MyEventHandlers</Name>
      <Type>ItemAdded</Type>
      <SequenceNumber>10000</SequenceNumber>
      <Assembly>MyEventHandlers, Version=1.0.0.0, Culture=neutral, PublicKeyToken=4358f2a5344ff0dc</Assembly>
      <Class>MyEventHandlers.SimpleEventHandler</Class>
      <Data></Data>
      <Filter></Filter>
    </Receiver>
  </Receivers>
</Elements>

Acerca de los tipos de contenido

Los tipos de contenido son bloques de creación reutilizables dentro del almacén de datos de SharePoint Foundation. Con frecuencia, un tipo de contenido tiene uno o varios receptores de eventos como parte de su definición de XML. En los casos en que se enlaza un tipo de contenido con una lista de objetivo, por ejemplo, los receptores de eventos contenidos en dicho tipo de contenido se registran en (o enlazan a) dicha lista de objetivo.

Precaución
A veces, el vocabulario de eventos y receptores de eventos usa los términos "registrar" y "enlazar" de forma indistinta. Aunque en esta documentación se habla de "enlazar" receptores de eventos, es posible que encuentre ocasionalmente referencias a "registrar" receptores de eventos. Ambos términos significan lo mismo.

Windows SharePoint Services 3.0 introdujo el concepto de tipos de contenido en el almacén de datos. En resumen, los tipos de contenido introducen la noción de reusabilidad. Mediante el uso de los tipos de contenido, se pueden crear clases de objetos con definiciones específicas y un posible comportamiento asociado, como nombre de tipo, campos, formato, procesos de negocio, retención, auditoría y control de eventos.

También puede activar listas y bibliotecas de SharePoint para admitir varios tipos de contenido. Al hacerlo, se puede adjuntar una o varias de estas clases a la lista o biblioteca y, de esa forma, ampliarla con funciones y comportamientos adicionales. Considere la ampliación de una lista de clientes con un tipo de contenido de contacto. El tipo de contenido de contacto puede proporcionar a la lista de clientes un conjunto de nuevos campos, como nombre del contacto, función, teléfono etc. y también con nuevo comportamiento.

Si necesita enlazar un controlador de eventos a una lista o biblioteca específica, o a un conjunto específico de listas o bibliotecas, normalmente puede hacerlo en el nivel de la característica. Sin embargo, también puede hacerlo mediante el uso de la propiedad EventReceivers en el objeto correspondiente (por ejemplo, en los objetos de tipo de contenido o lista, mediante EventReceivers y EventReceivers, respectivamente).

Con respecto a las listas y bibliotecas, las características son un concepto individual de SharePoint Foundationque representa secciones específicas del Lenguaje de marcado de la aplicación de colaboración (CAML) que se consolidaron previamente en un mismo archivo (Schema.xml u Onet.xml). Estas secciones CAML son aisladas, lo que significa que puede reutilizarlas en distintos lugares. Ahora la estructura y la definición de campos de una lista se crean mediante una característica de SharePoint.

Con respecto al enlace del controlador de eventos, puede usar el concepto de la característica para enlazar el ensamblado a una lista o biblioteca específica (especificando el GUID de la lista o biblioteca) o para un determinado tipo de lista o biblioteca (por ejemplo, todas las bibliotecas de documentos o todas las bibliotecas de formularios). Para definir una característica, debe crear los dos mismos tipos de archivo XML (Feature.xml y Element.xml), tal como se describe en Enlace de un controlador de eventos de SharePoint Foundation.

Vea también

Compartir a través de

Enlace de controladores de eventos mediante el archivo Features.xml de SharePoint

Uso de características de SharePoint

Acerca de los tipos de contenido

Vea también

Tareas

Conceptos

Otros recursos

Recursos adicionales