Bloque de creación: Características

Artículo
09/24/2014

Última modificación: martes, 22 de diciembre de 2009

Hace referencia a: SharePoint Foundation 2010

En este artículo
Modelo de objetos para características
XML usado para características
Áreas relacionadas con características
Más información sobre características

Una característica es un contenedor que incluye una o varias extensiones de funcionalidad en Microsoft SharePoint Foundation. Una característica contiene un archivo Feature.xml y uno o varios archivos de elemento. Estos archivos XML también se conocen como definiciones de características.

Las características pueden contener plantillas, páginas, definiciones de listas, controladores de eventos, flujos de trabajo, personalizaciones y otros objetos. El directorio que contiene la característica también puede contener otros archivos de recursos como páginas, imágenes, archivos ECMAScript (JavaScript, JScript) u hojas de estilos en cascada (CSS). Las características también pueden depender de otra característica que se haya aplicado en un ámbito más amplio. Por ejemplo, una característica con ámbito al nivel de sitio puede depender de una característica con ámbito al nivel de la colección de sitios. En cambio, una característica que se activa en un ámbito más amplio no puede depender de una característica que se activa en un ámbito más pequeño.

Las características también contienen receptores de características. Éstos son ensamblados que contienen código que se ejecuta cuando se instala, desinstala, activa, desactiva o actualiza una característica. Para obtener más información acerca de los receptores de características, vea Eventos Feature.

Granja de servidores – La característica estará disponible en la granja de servidores.
Aplicación web – La característica estará disponible en la aplicación web.
Colección de sitios – La característica estará disponible en una colección de sitios.
Sitio – La característica estará disponible en un solo sitio.

Modelo de objetos para características

Las características pueden manipularse usando el modelo de objetos de SharePoint Foundation. Esto incluye encontrar información acerca de una característica, recuperar una lista de características instaladas y determinar dependencias de activación. Las clases siguientes pueden usarse para trabajar con características usando el modelo de objetos.

Espacio de nombres Microsoft.SharePoint

SPFeature – Objeto que representa una característica. La colección de características se almacena en un objeto SPFeatureCollection. Para tener acceso a la SPFeatureCollection, se puede usar la propiedad Features de los objetos SPWebService, SPWebApplication, SPSite y SPWeb. Si aparece una característica en la colección, se ha activado en el ámbito especificado.

SPFeatureProperty – Objeto que representa una sola propiedad de un objeto SPFeature. La colección de propiedades se almacena en un objeto SPFeaturePropertyCollection. Para tener acceso al objeto SPFeaturePropertyCollection, se puede usar la propiedad Properties del objeto SPFeature.

SPFeatureScope – Enumeración de los diferentes ámbitos que se pueden especificar para una característica: Farm, WebApplication, Site y Web.

SPFeatureDependency – Objeto que representa una característica de la que depende otra característica. La colección de características de las que depende otra característica se almacena en un objeto SPFeatureDependencyCollection. Para tener acceso al objeto SPFeatureDependencyCollection, se puede usar la propiedad ActivationDependencies del objeto SPFeatureDefinition.

Espacio de nombres Microsoft.SharePoint.Administration

SPFeatureDefinition – Objeto que representa la definición básica de una característica, incluido el nombre, el ámbito, el Id. y la versión. La colección de definiciones de una característica se almacena en un objeto SPFeatureDefinitionCollection. Para tener acceso al objeto SPFeatureDefinitionCollection, se puede usar la propiedad FeatureDefinitions de los objetos SPFarm o SPSite.

SPElementDefinition – Objeto que representa un elemento que se aprovisiona cuando se activa o se usa una característica. La colección de definiciones de elementos se almacena en un objeto SPElementDefinitionCollection. Para tener acceso al objeto SPElementDefinitionCollection, se puede usar el método GetElementDefinitions(CultureInfo) del objeto SPFeatureDefinition.

XML usado para características

Las características se construyen principalmente usando dos archivos XML: un archivo Feature.xml y un archivo de elemento de característica. Estos dos archivos definen el ámbito, las dependencias y cualquier archivo relacionado que se implementará en el servidor front-end web.

Archivo de manifiesto de elemento de característica

El archivo Feature.xml se usa para especificar la ubicación de los ensamblados, archivos, dependencias o propiedades que admiten la característica. El elemento Elemento ElementManifest (Característica) apunta al archivo de manifiesto de característica acompañante que define la característica. Para obtener más información sobre los valores que se usan para atributos, vea Archivos Feature.xml. A continuación se muestra la forma que puede tener un archivo Feature.xml básico.

<Feature Title="Feature Title"
  Scope="FeatureScope" 
  Id="GUID" 
  xmlns="https://schemas.microsoft.com/sharepoint/">
  <ElementManifests>
    <ElementManifest Location="FeatureManifestFileName.xml" />
  </ElementManifests>
</Feature>

Archivo de elemento de característica

Un archivo de elemento de característica puede tener cualquier nombre. Cuando se define un archivo Feature.xml, debe hacerse referencia al nombre de archivo del elemento Elemento ElementManifest (Característica). Este archivo puede contener un elemento Elemento CustomAction, personalizaciones de interfaz de usuario, personalizaciones de cinta y muchas otras personalizaciones. Para obtener información acerca de la estructura del archivo, vea Esquemas de características. A continuación se muestra la forma que puede tener un archivo de elemento de característica.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <CustomAction Id="Ribbon.Library.Actions.AddAButton"
    Location="ViewToolbar"
    RegistrationId="101"
    RegistrationType="List"
    Title="Add a Ribbon Button">
    <CommandUIExtension>
      <CommandUIDefinitions>
        <CommandUIDefinition
          Location="Ribbon.Library.Actions.Controls._children">
          <Button Id="Ribbon.Library.Actions.Controls.NewRibbonButton"
            Command="NewRibbonButtonCommand"
            Image16by16="/_layouts/images/FILMSTRP.GIF"
            Image32by32="/_layouts/images/PPEOPLE.GIF"
            LabelText="Hello World"
            TemplateAlias="o2" />
        </CommandUIDefinition>
      </CommandUIDefinitions>
      <CommandUIHandlers>
        <CommandUIHandler 
          Command="NewRibbonButtonCommand"
          CommandScript="javascript:alert('Hello, world');" />
      </CommandUIHandlers>
    </CommandUIExtension>
  </CustomAction>
</Elements>