Elemento PropertySchema (Tipos de campo)

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

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios

Importante

En este tema se describe el marcado usado en un método obsoleto de representación de propiedades de tipo de campo personalizado. Se proporciona exclusivamente para ayudar con la depuración de propiedades de tipo de campo personalizado desarrolladas en versiones anteriores de SharePoint Foundation. Para obtener información sobre el método recomendado, vea Representación de propiedades de tipo de campo personalizado.

Representa el esquema de ciertas propiedades variables especiales de un tipo de campo personalizado, con cada propiedad definida como un elemento Field.

<PropertySchema>
</PropertySchema>

Atributos

Atributo	Descripción
Ninguno

Elementos secundarios

Elemento Fields (esquema de propiedad de tipos de campo)

Elementos primarios

Elemento FieldType (Tipos de campo)

Comentarios

Los tipos de campos personalizados pueden tener propiedades especiales cuyo valor variará de una columna basada en el tipo de campo a otra columna basada en el mismo tipo de campo. Piense en un tipo de campo de expresiones regulares personalizado que está diseñado para contener valores String que coincidan con una expresión regular determinada,como ^(\d{3})\d{3}-\d{4}$ para números de teléfono americanos. En lugar de crear tipos de campo de expresiones regulares personalizados por separado para los números de matrícula británicos, números de la seguridad social americanos, números de teléfono chinos, etc., resulta más eficaz crear un único tipo de campo de expresión regular y habilitar los usuarios que crean columnas según el tipo de campo, para establecer la expresión regular que debe asociarse columna por columna. Por ejemplo, un usuario que cree una columna "Número de teléfono de EE.UU." establecería la expresión regular de la columna a la cadena anterior. Otro usuario, al crear una columna " Apartado de correos brasileño " establecería la expresión regular de su columna como ^\d{5}\-\d{3}$.

Para ello, el campo personalizado necesita una propiedad RegularExpression que se represente en un control editable en la interfaz de usuario cuando se crea una nueva columna. En SharePoint Foundation, se encuentra en la sección Configuración de columna adicional de la página Nueva columna de sitio y la página Crear columna. El elemento PropertySchema en el archivo fldtypes*.xml es donde dichas propiedades de variables se declaran y proporcionan un esquema de representación predeterminado. Opcionalmente, pueden también proporcionar valores predeterminados.

Nota

Si define las propiedades variables del tipo de campo personalizado en el elemento PropertySchema, SharePoint Foundation representa automáticamente dichas propiedades en función del esquema. Además, puede definir la representación de sus propiedades de tipo de campo mediante un control de usuario del editor de campos.

Ejemplo

En el siguiente ejemplo se define un esquema de propiedad para un tipo de campo personalizado llamado "RegularExpressionMatch". El esquema declara un campo que pueden usar los creadores de las columnas al basar una columna en el tipo de campo. La finalidad del campo es permitir al creador de las columnas establecer una expresión regular diferente para cada columna basada en el tipo de campo RegularExpressionMatch.

Aparecen DisplayName y un campo Text editable en la sección Configuración de columna adicional de la página Nueva columna de sitio y la página Crear columna. El atributo MaxLength establece la longitud máxima, en caracteres, de la expresión regular y DisplaySize establece el tamaño del campo que la contiene. Los usuarios pueden desplazarse por el campo para ver el resto de la expresión regular si tiene una longitud superior a la mostrada en el campo DisplaySize.

No se ha establecido ningún valor predeterminado en este ejemplo, pero si el desarrollador del tipo de campo sabe que en la mayoría de los casos se utilizará para crear columnas que contengan números de teléfono americanos, podría establecer el valor predeterminado como <Default>^(\d{3})\d{3}-\d{4}$</Default>.

Nota: el siguiente ejemplo de código se ha editado para que resulte más claro.

<FieldType>
  <Field Name="TypeName">RegularExpressionMatch</Field>
  …
  <PropertySchema>
    <Fields>
      <Field Name="RegularExpression" 
             DisplayName="Regular Expression To Match" 
             MaxLength="500" 
             DisplaySize="100" 
             Type="Text">
        <Default></Default>
      </Field>
    </Fields>
  </PropertySchema>
  …
</FieldType>

Vea también

Conceptos

Tipos de campos personalizados

Procedimiento para crear una clase de campos personalizados

Representación de propiedades de tipo de campo personalizado

Procedimiento para crear una definición de tipo de campo personalizado