Elemento Field (List)

Última modificación: jueves, 13 de febrero de 2014

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones

Define los tipos de datos internos usados en la infraestructura de lista de un sitio web de SharePoint. Un campo es una columna o atributo de información que un usuario puede agregar a una lista.

<Field
  Aggregation = "sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  AllowDeletion = "TRUE" | "FALSE"
  AllowHyperlink = "TRUE" | "FALSE"
  AllowMultiVote = "TRUE" | "FALSE"
  AppendOnly = "TRUE" | "FALSE"
  AuthoringInfo = "Text"
  BaseType = "Integer" | "Text"
  CalType = "Integer"
  CanToggleHidden = "TRUE" | "FALSE"
  ClassInfo = "Text"
  ColName = "Text"  ColName2 = "Text"
  Commas = "TRUE" | "FALSE"  Customization = "Text"
  Decimals = "Integer"
  Description = "Text"
  Dir = "Text"  Direction = "Text"
  DisplaceOnUpgrade = "TRUE" | "FALSE"
  DisplayImage = "Text"
  DisplayName = "Text"
  DisplayNameSrcField = "Text"  DisplaySize = "Integer"
  Div = "Number"
  EnableLookup = "TRUE" | "FALSE"  EnforceUniqueValues = "TRUE" | "FALSE"
  ExceptionImage = "Text"
  FieldRef = "Text"
  FillInChoice = "TRUE" | "FALSE"
  Filterable = "TRUE" | "FALSE"
  FilterableNoRecurrence = "TRUE" | "FALSE"
  ForcedDisplay = "Text"  ForcePromoteDemote = "TRUE" | "FALSE"
  Format = "Text"
  FromBaseType = "TRUE" | "FALSE"
  Group = "Text"
  HeaderImage = "Text"
  Height = "Integer"
  Hidden = "TRUE" | "FALSE"
  HTMLEncode = "TRUE" | "FALSE"
  ID = "Text"  Id = "Text"
  IMEMode = "inactive"
  Indexed = "TRUE" | "FALSE"
  IsolateStyles = "TRUE" | "FALSE"  IsRelationship = "TRUE" | "FALSE"
  JoinColName = "Text"
  JoinRowOrdinal = "Integer"
  JoinType = "INNER" | "LEFT OUTER" | "RIGHT OUTER"
  LCID = "Integer"  LinkToItem = "TRUE" | "FALSE"  LinkToItemAllowed = "Text"
  List = "Text"  ListItemMenu = "TRUE" | "FALSE"  ListItemMenuAllowed = "Text
  Max = "Number"
  MaxLength = "Integer"
  Min = "Number" 
  Mult = "TRUE" | "FALSE"
  Name = "Text"
  NegativeFormat = "MinusSign" | "Parens"
  Node = "Text"
  NoEditFormBreak = "TRUE" | "FALSE"
  NumLines = "Integer"
  Percentage = "TRUE" | "FALSE"
  PIAttribute = "Text"
  PITarget = "Text"
  PrependId = "TRUE" | "FALSE"
  Presence = "TRUE" | "FALSE"
  PrimaryKey = "TRUE" | "FALSE"
  PrimaryPIAttribute = "Text"
  PrimaryPITarget = "Text"
  ReadOnly = "TRUE" | "FALSE"
  ReadOnlyEnforced = "TRUE" | "FALSE"  RelationshipDeleteBehavior = "Text"
  RenderXMLUsingPattern = "TRUE" | "FALSE"
  Required = "TRUE" | "FALSE"
  RestrictedMode = "TRUE" | "FALSE"
  ResultType = "Text"
  RichText = "TRUE" | "FALSE"
  RichTextMode = "Text"
  RowOrdinal = "Integer"
  Sealed = "TRUE" | "FALSE"
  SeparateLine = "TRUE" | "FALSE"
  SetAs = "Text"
  ShowAddressBookButton = "TRUE" | "FALSE"  ShowAlways = "TRUE" | "FALSE"
  ShowField = "Text" | "Choice" | "Counter"
  ShowInDisplayForm = "TRUE" | "FALSE"
  ShowInEditForm = "TRUE" | "FALSE"
  ShowInFileDlg = "TRUE" | "FALSE"
  ShowInListSettings = "TRUE" | "FALSE"
  ShowInNewForm = "TRUE" | "FALSE"
  ShowInVersionHistory = "TRUE" | "FALSE"
  ShowInViewForms = "TRUE" | "FALSE"
  Sortable = "TRUE" | "FALSE"
  SourceID = "Text"
  StaticName = "Text"
  StorageTZ = "UTC" | "Abstract"
  StripWS = "TRUE" | "FALSE"
  SuppressNameDisplay = "TRUE" | "FALSE"
  TextOnly = "TRUE" | "FALSE"
  Title = "Text" 
  Type = "Data_Type"
  UniqueId = "Text"
  UnlimitedLengthInDocumentLibrary = "TRUE" | "FALSE"
  URLEncode = "TRUE" | "FALSE"
  URLEncodeAsUrl = "TRUE" | "FALSE"
  UserSelectionMode = "Text"
  UserSelectionScope = "Integer"  Version = "Text"
  Viewable = "TRUE" | "FALSE"  WebId = "Text"
  Width = "Integer"
  WikiLinking = "TRUE" | "FALSE"
  XName = "Text">
</Field>

Atributos

Atributo

Descripción

Aggregation

Text opcional. Se usa en un campo de agregado en un formulario XML para especificar la función que se aplicará a una colección de valores o elementos devueltos por una expresión XPath. Si usa el atributo Node para especificar una expresión XPath que devuelve una colección de valores, también puede incluir un atributo Aggregation que especifica la acción que se realizará en el conjunto de valores devuelto. Esta acción puede ser bien de agregación, o bien una indicación del elemento concreto dentro de la colección.

Los valores posibles son:

  • sum   Sumar los valores.

  • count   Contar el número de valores.

  • average   Encontrar el promedio de los valores.

  • min   Encontrar el valor mínimo.

  • max   Encontrar el valor mínimo.

  • merge   Combinar los valores.

  • plaintext   Convertir el contenido de texto del nodo en texto sin formato.

  • first   Aplicar la promoción y degradación de propiedades al primer elemento de la colección.

  • last   Aplicar la promoción y degradación de propiedades al último elemento de la colección.

Para obtener más información sobre la forma en que se usan los atributos Node, PIAttribute, PITarget, PrimaryPIAttribute y PrimaryPITarget para la promoción y degradación de propiedades en documentos XML, consulte Uso de tipos de contenido para especificar propiedades de documentos XML.

AllowDeletion

Boolean opcional. TRUE si se puede eliminar el campo.

AllowHyperlink

Boolean opcional. TRUE si se pueden usar hipervínculos en el campo.

AllowMultiVote

Boolean opcional. TRUE si se permiten varias respuestas en una encuesta.

AppendOnly

Boolean opcional. Cuando se habilita en la lista el control de versiones, TRUE si solamente se puede agregar texto al existente en el campo Note.

AuthoringInfo

Text opcional. Una cadena descriptiva que se muestra en el páginas de edición de campos para identificar el campo y su propósito; por ejemplo, el campo LinkTitle contiene la información de creación "(vínculo al elemento)". Este atributo suele usarse si existe un campo del mismo nombre con otro propósito.

BaseType

Opcional. El atributo BaseType se puede establecer como Integer, que almacena valores como enteros, o como Text (predeterminado), que almacena valores como texto. No se pueden crear campos de elección con un tipo base de entero.

CalType

Integer opcional. Especifica el tipo de calendario. Entre los posibles valores se incluyen:

  • 16   Era Saka

  • 15   Chino lunar

  • 14   Lunar coreano y japonés

  • 12   Gregoriano (transliteración al francés)

  • 11   Gregoriano (transliteración al inglés)

  • 10   Gregoriano (árabe)

  • 9   Gregoriano (francés de Oriente Medio)

  • 8   Hebreo (lunar)

  • 7   Tailandés

  • 6   Hijri (lunar árabe)

  • 5   Coreano (era de Tangún)

  • 4   Era Taiwán

  • 3   Era del emperador japonés

  • 1   Gregoriano

  • 0   No especifica ningún tipo

CanToggleHidden

Boolean opcional. TRUE si el campo puede estar oculto a través de la interfaz de usuario.

ClassInfo

Text opcional. Especifica una clase de hoja de estilos en cascada (CSS) que se va a usar para el campo en la vista de tabla estándar. Si está activada, la clase especificada se usa en lugar de la clase ms-vb2 estándar.

ColName

Text opcional. Un atributo interno que define la asignación del campo al nombre de almacenamiento físico para este campo. Este nombre debe ser válido en la base de datos subyacente y debe ser idéntico al nombre usado en la base de datos. Si no se especifica, el servidor genera un nombre de columna que no entra en conflicto con ninguno de los nombres de columna existentes y que sólo contiene caracteres permitidos por Microsoft SQL Server.

ColName2

Text opcional.

Commas

Boolean opcional. TRUE si se usan comas como separador de millares.

Customization

Text opcional.

Decimals

Integer opcional. Determina el número de decimales que se muestran. El valor mostrado se redondea con la precisión de presentación; por ejemplo, 1,05 se muestra como 1,1 cuando se redondea a una posición decimal.

Description

Text opcional. Proporciona la descripción que se muestra en el formulario de edición de una lista si se especifica una descripción de campo. De manera predeterminada, los campos de Microsoft SharePoint Foundation no tienen descripciones.

Dir

Text opcional. Especifica la dirección del texto en un campo que admite la lectura bidireccional. Los posibles valores son LTR (de izquierda a derecha), RTL (de derecha a izquierda) y none.

Direction

Text opcional.

DisplaceOnUpgrade

Boolean opcional. Si ya existe una definición para el campo, TRUE para forzar actualizaciones de propiedades de campo con los valores que se especifican en esta definición de campos.

DisplayImage

Text opcional. Especifica el nombre de un icono que se muestra para la columna.

DisplayName

Text opcional. El nombre mostrado para un campo. No hay ninguna restricción en el tamaño del texto ni en el uso de espacios. El nombre para mostrar puede ser editado por el usuario y puede cambiar tras la creación inicial del campo. Este nombre se usa como encabezado de columna cuando el campo se muestra en una vista de tabla y como etiqueta de formulario cuando el campo se muestra en un formulario. La etiqueta <FieldName/> devuelve el nombre para mostrar si se da; en caso contrario, se usa de forma predeterminada el atributo Name.

DisplayNameSrcField

Text opcional. Generalmente se usa para un campo calculado que necesita el mismo nombre que otro campo. Si se modifica el campo de origen y un usuario cambia su nombre para mostrar, a continuación, el nombre para mostrar de este campo también cambiará. Esta cadena hace referencia al nombre del otro campo.

DisplaySize

Integer opcional.

Div

Number opcional. Un factor de escala usado en una división antes de mostrar un número. El número para mostrar es N * Mult / Div (redondeado al número especificado por Decimals).

EnableLookup

Boolean opcional. TRUE para habilitar valores de búsqueda en el campo.

EnforceUniqueValues

Boolean opcional.

ExceptionImage

Text opcional. Se utiliza en un tipo de campo Recurrence para especificar el nombre del archivo de imagen que se va a utilizar para excepciones.

FieldRef

Text opcional. Especifica el nombre de otro campo al que el campo hace referencia, como un campo de búsqueda.

FillInChoice

Boolean opcional. TRUE si el campo permite a los usuarios rellenar valores de la columna.

Filterable

Boolean opcional. TRUE si el campo se puede filtrar.

FilterableNoRecurrence

Boolean opcional. TRUE si se puede crear un filtro en el campo en una vista que no expande eventos periódicos. Si Filterable contiene TRUE, el campo se puede filtrar en todas las vistas independientemente de cómo está establecido FilterableNoRecurrence.

ForcedDisplay

Text opcional. Especifica el texto para mostrar en lugar del valor de campo real. Este atributo se usa en encuestas para evitar que se muestre el nombre de usuario.

ForcePromoteDemote

Boolean opcional.

Format

Text opcional. Especifica el formato que se va a usar para los valores numéricos.

Para los campos de fecha y hora, los siguientes valores son posibles:

  • DateOnly   Mostrar (y permitir las modificaciones) sólo la parte de fecha (la parte de tiempo se establece en 12:00 A.M. para todos los valores modificados).

  • DateTime   Mostrar y editar tanto la fecha como la hora del día (valor predeterminado).

  • ISO8601   Mostrar fecha y hora en formato de hora ISO8601 convertido al formato hora universal coordinada (UTC): AAAA-MM-DDTHH:MM:SSZ. Este formato es el utilizado para las propiedades de documentos de 2007 Microsoft Office system , así como para el formato de intercambio estándar usado en SharePoint Foundation entre los formularios New y Edit y el servidor.

  • ISO8601Basic   Usar la forma abreviada de formatos de fecha y hora 8601: AAAAMMDDTHHMMSSZ. Este es el formato utilizado para vCard/iCal.

Para los campos de elección, este atributo se puede establecer como Dropdown (valor predeterminado), que proporciona opciones de edición mediante una selección desplegable, o como RadioButtons, que proporciona opciones mediante un grupo de botones de opción.

Para los campos de direcciones URL, este atributo se puede establecer como Hyperlink (valor predeterminado), que muestra la dirección URL como una etiqueta <A> normal, o como Image, que muestra la dirección URL como <IMG SRC="URL" ALT="Description">.

FromBaseType

Boolean opcional. Este atributo está en desuso en favor del atributo Sealed.

Group

Text opcional. Especifica el grupo de columnas al que pertenece el campo.

HeaderImage

Text opcional. Especifica el nombre de un archivo de imagen que se va a usar como encabezado del campo.

Height

Integer opcional. Especifica la altura en píxeles de las imágenes que se muestran a los usuarios en la lista Información del usuario.

Hidden

Boolean opcional. Si está establecido como TRUE, el campo está completamente oculto en la interfaz de usuario. Si se establece ReadOnly como TRUE, significa que el campo no se muestra en formularios nuevos o de edición pero todavía se puede incluir en vistas.

HTMLEncode

Boolean opcional. TRUE para convertir caracteres incrustados de manera que se muestren como texto en el explorador; los caracteres que se podrían confundir con etiquetas HTML se convierten en entidades.

ID

Text opcional. Especifica el GUID del campo que se encuentra entre corchetes ({}).

Id

Text opcional.

IMEMode

Text opcional. Especifica el sesgo del modo Editor de métodos de entrada (IME) para usar en el campo. El IME permite la conversión de pulsaciones de teclas entre idiomas cuando un sistema de escritura tiene más caracteres de los que se pueden codificar para el teclado determinado.

A continuación se muestran los posibles valores:

  • auto   No se usa. Para especificar este modo IME, establezca el valor de la propiedad IMEMode como una cadena vacía ("").

  • active   Todos los caracteres se escriben mediante el IME, pero los usuarios aún puede desactivar el Editor de métodos de entrada. .

  • inactive   Los caracteres se escriben sin el IME, aunque los usuarios pueden seguir activándolo.

Indexed

Boolean opcional. TRUE si la columna está indizada para su uso en filtros de vista.

IsolateStyles

Boolean opcional. Para un campo Text cuyo atributo RichText es TRUE y cuyo atributo RichTextMode es FullHtml, este atributo especifica que un servidor vuelva a escribir el HTML del campo para garantizar que no interfiera con la representación de la página que lo rodea.

IsRelationship

Boolean opcional. TRUE si el campo se puede detectar a partir de la lista en la que busca su valor.

JoinColName

Text opcional. Este atributo se define sólo para campos de búsqueda. Es muy similar a ColName, excepto en que denota el nombre de la columna que se usan en SQL JOIN entre las listas locales y externas. Normalmente, no se debe personalizar este valor. Sólo se usa actualmente en el esquema de campo de ciertos campos integrados y de tipo base para indicar búsquedas en la tabla de direcciones URL (DocMd), que se une en la columna UrlID.

JoinRowOrdinal

Integer opcional. No pensado para utilizarlo directamente desde el código.

JoinType

Text opcional. Especifica el tipo de JOIN usado en el campo. Los posibles valores incluyen INNER, LEFTOUTER y RIGHTOUTER.

LCID

Integer opcional. El atributo LCID se puede usar para especificar el país o región cuyo formato de moneda se usa, por ejemplo, 1033 para los Estados Unidos.

Dos casos especiales existen para el formato del símbolo de euro. Si LCID = -1 (0xFFFFFFF), el símbolo del euro se agrega como un prefijo al número. Si LCID = -2 (0xFFFFFFE), el símbolo de euro se agrega como un sufijo al número. El número de dígitos decimales es 2, aunque esto puede ser reemplazado por el atributo Decimals del campo. El símbolo de la moneda de euro es igual a 0x20AC en UCS-2.

LinkToItem

Boolean opcional.

LinkToItemAllowed

Text opcional.

List

Text opcional. Especifica el nombre interno de una lista.

ListItemMenu

Boolean opcional.

ListItemMenuAllowed

Text opcional.

Max

Number opcional. Especifica el valor máximo permitido para el campo.

MaxLength

Integer opcional. Especifica el número máximo de caracteres permitidos en un valor de campo. Los formularios de edición se ajustan para exigir este valor, que se valida en el cliente. Si el usuario intenta escribir un número de caracteres mayor que el establecido por MaxLength, aparece un mensaje de error.

Min

Number opcional. Especifica el valor mínimo permitido para el campo.

Mult

Boolean opcional. Un factor de escala usado en la multiplicación antes de mostrar un número.

Name

Text obligatorio. El nombre de un campo. Es el nombre interno de un campo y se garantiza que nunca cambiará mientras dure la definición de campo. Debe ser único con respecto al conjunto de campos de una lista. El nombre se genera de forma automática basándose en el nombre definido por el usuario para un campo.

NegativeFormat

Text opcional. Especifica cómo indicar los valores negativos. Se puede establecer en uno de los siguientes valores:

  • MinusSign   Usar el signo menos como prefijo.

  • Parens   Encerrar entre paréntesis.

Node

Text opcional. Usado en formularios XML, este atributo es necesario para todos los campos excepto para los vínculos de instrucciones de procesamiento (PI), y especifica la expresión XPath para un nodo que se promueve.

NoEditFormBreak

Boolean opcional. TRUE para impedir que un salto de línea se agregue entre los campos de un formulario de nuevo elemento o de edición de elemento. Algunos tipos de campo, como el campo de texto enriquecido, proporcionan el espaciado de forma predeterminada, y este atributo permite controlar el espacio adicional resultante.

NumLines

Integer opcional. Recomienda el número de líneas (filas) para mostrar en un bloque TEXTAREA durante la edición. Esto es simplemente una sugerencia de la interfaz de usuario del cliente; no se impone ninguna limitación en el número de líneas de texto que se pueden editar.

Percentage

Boolean opcional. TRUE si el valor se muestra como un porcentaje; es decir, un número multiplicado por 100 con un signo de porcentaje (%).

PIAttribute

Text opcional. Especifica el atributo de la instrucción de procesamiento de documentos (especificado por el atributo PITarget) que se va a utilizar como valor de la columna. Se utiliza para la promoción y degradación de propiedades en documentos XML. Si se especifica el atributo PIAttribute, también se debe especificar el PITarget.

Para obtener más información sobre la forma en que se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para la promoción y degradación de propiedades en documentos XML, consulte Uso de tipos de contenido para especificar propiedades de documentos XML.

PITarget

Text opcional. Especifica la instrucción de procesamiento de documentos en la que el valor de la columna se almacena en documentos de este tipo de contenido. Se utiliza para promoción y degradación de propiedades en documentos XML. Si se especifica el atributo PIAttribute, también se debe especificar el atributo PITarget.

Para obtener más información sobre la forma en que se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para la promoción y degradación de propiedades en documentos XML, consulte Uso de tipos de contenido para especificar propiedades de documentos XML.

PrependId

Boolean opcional. Utilizado en las listas de seguimiento de problemas, TRUE para mostrar los identificadores de recopilación de los elementos de problemas relacionados en los formularios Edición y Nuevo elemento.

Presence

Boolean opcional. TRUE si la información del usuario está presente para el campo.

PrimaryKey

Boolean opcional. TRUE si el campo es la clave principal en la relación entre la lista y otra lista.

PrimaryPIAttribute

Text opcional. Se utiliza para la promoción y degradación de propiedades en documentos XML. Especifica un atributo alternativo en la instrucción de procesamiento del documento, especificada por el PrimaryPITarget que se va a utilizar como valor de la columna. Si se especifica el atributo PrimaryPIAttribute, también se debe especificar el atributo PrimaryPITarget. Si se especifica, SharePoint Foundation utiliza estos valores antes de los especificados en los atributos PITarget y PIAttribute.

Para obtener más información sobre la forma en que se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget, para la promoción y degradación de propiedades en documentos XML, consulte Uso de tipos de contenido para especificar propiedades de documentos XML.

PrimaryPITarget

Text opcional. Especifica una instrucción de procesamiento de documentos alternativa en la que el valor de la columna se almacena para los documentos de este tipo de contenido. Si se especifica el atributo PrimaryPIAttribute , también se debe especificar el atributo PrimaryPITarget. Si se especifica, SharePoint Foundation utiliza estos valores antes que los especificados en los atributos PITarget y PIAttribute.

Para obtener más información sobre la forma en que se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para la promoción y degradación de propiedades en documentos XML, consulte Uso de tipos de contenido para especificar propiedades de documentos XML.

ReadOnly

Boolean opcional. Si se establece como TRUE, el campo no se muestra en formularios nuevos o de edición pero se puede incluir en vistas. Además, si se establece ReadOnly como TRUE, el campo se oculta en las páginas de configuración del sitio para administrar columnas de sitio y tipos de contenido. Establecer el atributo Hidden como TRUE oculta completamente el campo de la interfaz de usuario. Si no se incluye este atributo, SharePoint Foundation trata la columna como si este atributo estuviera establecido como False.

ReadOnlyEnforced

Boolean opcional. TRUE para especificar que el usuario no puede cambiar el campo por ningún medio y que sólo lo puede cambiar el sistema.

RelationshipDeleteBehavior

Text opcional. Especifica el comportamiento de eliminación del campo. Los valores posibles incluyen Cascade, Restrict y None.

RenderXMLUsingPattern

Boolean opcional. Se usa en campos calculados para determinar el formato de presentación. Si se establece como TRUE, los valores se representan en función del modelo de presentación del campo calculado, en lugar del valor de la primera referencia del campo no calculado en la que se basa el campo calculado. Por ejemplo, en una biblioteca de imágenes, la columna de tamaño de imagen se representa como ancho x alto, pero si este atributo no se establece como TRUE, solo se muestra la primera referencia del campo: ancho. Si se establece como TRUE, se muestra el formato ancho x alto.

Required

Boolean opcional. Si se establece como TRUE, el campo no debe tener asignado un valor vacío. Si no se proporciona un valor de campo no vacío en un envío de formulario, se muestra el texto de campo necesario estándar o un mensaje explícitamente específico (es decir, mediante etiquetas <ErrorText>) en el formulario de error. La validación es controlada sólo por el cliente (la base de datos siempre permite el valor NULL para todos los campos definidos por el usuario).

RestrictedMode

Boolean opcional. TRUE para no permitir que el campo Note tenga formato de texto enriquecido mejorado, como imágenes, tablas o hipervínculos, ni tampoco pegar texto con formato en el campo.

ResultType

Text opcional. Especifica el tipo de datos de valores que se devuelven desde el campo.

RichText

Boolean opcional. TRUE si el campo muestra formato de texto enriquecido.

RowOrdinal

Integer opcional. Especifica la ubicación de la base de datos para el campo.

Sealed

Boolean opcional. Si se establece este atributo como TRUE para un campo del archivo Schema.xml de una lista, el campo se marca como inamovible en la página Cambiar columna.

SeparateLine

Boolean opcional. Se usa internamente para admitir la presentación de un campo (por ejemplo, notas o comentarios) en una línea independiente. Este atributo no es de uso público.

SetAs

No está pensado para usarse directamente desde el código.

ShowAddressBookButton

No está pensado para usarse directamente desde el código.

ShowAlways

Boolean opcional.

ShowField

Opcional. El atributo ShowField se puede establecer como el nombre de campo para mostrar. De manera predeterminada se muestra un texto con hipervínculo del campo de título del registro de la lista externa. Sin embargo, el atributo ShowField se puede usar para invalidar este valor y mostrar otro campo de la lista externa. Se permiten los siguientes tipos de datos como destino de un atributo a ShowField: Text, Choice, y Counter. Para un campo Lookup, este parámetro debe establecerse como el nombre de campo interno; si se establece como el nombre para mostrar no provoca un error, pero interrumpe el campo.

ShowInDisplayForm

Boolean opcional. TRUE para mostrar el campo en el formulario para ver el elemento.

ShowInEditForm

Boolean opcional. TRUE para mostrar el campo en el formulario para editar el elemento.

ShowInFileDlg

Boolean opcional. Este atributo sólo es válido para campos de esquemas de biblioteca de documentos. Si se establece como FALSE, el campo no se mostrará en el cuadro de diálogo de propiedades para guardar formularios que aparece cuando se guarda desde aplicaciones cliente. Por ejemplo, el campo de título tiene este atributo porque se establece directamente en el documento que se guarda en la biblioteca de documentos.

ShowInListSettings

Boolean opcional. TRUE para mostrar la columna en la página para personalizar la configuración de las listas.

ShowInNewForm

Boolean opcional. Si se establece como FALSE, el campo no aparecerá en una enumeración de Fields cuando el modo de presentación está establecido como New. Los campos con esta configuración no aparecen en la página Nuevo elemento predeterminada de una lista determinada. En concreto, esto se usa para ocultar campos en la página para cargar documentos en la biblioteca de documentos.

ShowInVersionHistory

Boolean opcional. TRUE para mostrar la columna en la página para ver versiones de elementos de lista.

ShowInViewForms

Boolean opcional. TRUE para especificar que el campo se muestra en las páginas que se utilizan para ver los datos de la lista.

Sortable

Boolean opcional. TRUE si se pueden ordenar los valores en el campo.

SourceID

Text opcional. Contiene el espacio de nombres que define el campo, por ejemplo, https://schemas.microsoft.com/sharepoint/v3 o el GUID de la lista en que se creó el campo personalizado.

StaticName

Text opcional. Contiene el nombre interno del campo.

StorageTZ

Especifica cómo se almacenan los valores de fecha y hora. Cuando StorageTZ se establece como UTC, la fecha y la hora se trata como Hora universal coordinada (UTC). Para indicar que un valor de fecha y hora hace referencia a tiempo "abstracto", lo que significa que la fecha y la hora se almacenan en la base de datos tal y como la escribe el usuario sin conversión o almacenamiento de la zona horaria local, omita el atributo StorageTZ.

StripWS

Boolean opcional. TRUE si se quita el espacio en blanco al principio y al final de los valores de campo.

SuppressNameDisplay

Boolean opcional. TRUE para no mostrar el nombre del usuario en un campo User.

TextOnly

Boolean opcional. Si se establece como TRUE, el campo sólo puede contener valores Text.

Title

Text opcional. Contiene el título del campo que se muestra en la interfaz de usuario.

Type

Text obligatorio. El tipo de datos del campo (a menos que el elemento Field sea secundario de ProjectedFields).

NotaNota
En la versión de la vista previa técnica de Microsoft SharePoint Foundation 2010, el atributo Type tiene un significado distinto y solo un valor posible ("Lookup") cuando es elemento secundario de ProjectedFields. Vea Elemento ProjectedFields (View) para obtener más información acerca de este uso de Type.

SharePoint Foundation incluye los siguientes tipos de datos de manera predeterminada:

  • AllDayEvent   Especifica un evento de todo el día. Se corresponde con el tipo de datos bit de SQL.

  • Attachments   Almacena las direcciones URL de los datos adjuntos. Se corresponde con el tipo de datos bit de SQL.

  • Boolean   Se utiliza para almacenar un valor TRUE/FALSE (que se guarda en la base de datos como 0 o 1). Este campo se puede ordenar y agrupar, Se corresponde con el tipo de datos bit de SQL y está representado por la clase SPFieldBoolean.

  • Calculated   Especifica un campo cuyo valor se calcula basándose en otras columnas. Se corresponde con el tipo de datos sql_variant de SQL y está representado por la clase SPFieldCalculated.

  • Choice   Permite al usuario especificar un conjunto de valores predeterminados que se pueden utilizar para introducir datos en el campo. Los tipos Choice y Lookup son los campos más importantes para ordenar y agrupar. Los atributos BaseType y Format se pueden usar para campos de elección. Este campo se puede ordenar y agrupar. Cuando se da un valor para una opción de elección, ese valor se usa como el valor enviado para la selección del campo. Cuando no se da un valor, la elección se envía como un valor de texto de la elección. En todos los casos, el valor de texto de la elección es lo que se muestra en la interfaz de usuario (texto de botón de radio o lista desplegable). El orden en que las opciones aparecen en la interfaz de usuario de edición siempre es el orden de los elementos tal y como se especifican en el elemento CHOICES. Use el tipo MultiChoice para especificar un campo Choice que implementa casillas de verificación y permite al usuario seleccionar varios valores. Se corresponde con el tipo de datos nvarchar de SQL y está representado por la clase SPFieldChoice.

  • Computed   Especifica un campo cuyo contenido depende de otro campo. Por ejemplo, un campo LinkTitleNoMenu equivale a rodear a un valor de campo de título con un hipervínculo. Representado por la clase SPFieldComputed.

  • ContentTypeId   Contiene un identificador de tipo de contenido. Para obtener información sobre el formato de los identificadores de tipo de contenido, consulte Identificadores de tipo de contenido. Se corresponde con el tipo de datos varbinary de SQL.

  • Counter   Normalmente utilizado sólo para el campo Id. interno. Su valor entero se establece automáticamente sean únicos con respecto a todos los demás elementos de la lista actual. El tipo Counter es siempre de sólo lectura y no se puede establecer mediante un envío de formulario. Este campo se puede ordenar pero no agrupar. Se corresponde con el tipo de datos int de SQL.

  • CrossProjectLink    Se usa para conectar un evento en una lista de SharePoint con un sitio de área de reuniones; hace referencia específicamente al tipo de campo de la casilla usada en los formularios Nuevo y Editar elemento para crear un sitio de área de reuniones para el elemento. Se corresponde con el tipo de datos bit de SQL y está representado por la clase SPFieldCrossProjectLink.

  • Currency   Permite introducir un valor de moneda. Cada campo de moneda está vinculado a la moneda de una configuración regional específica. En todos los demás aspectos, se trata como el tipo de campo Number. Use el atributo LCID para indicar la moneda de una configuración regional específica. Los atributos Decimals, Max y Min se pueden usar para tipos de moneda. Este campo se puede ordenar y agrupar. Corresponde al tipo de datos SQL float y se representa con la clase SPFieldCurrency.

  • DateTime   Permite el almacenamiento completo de una fecha u hora del día. Use el atributo Format para especificar el formato de fechas y el atributo StorageTZ para determinar el modo en que se almacenan los valores de fecha y hora. Este campo se puede ordenar y agrupar. Para el modo de presentación, el orden del formato de fecha se extrae de la configuración regional ("M/D/A" o "D/M/A"). En el modo Edición (o en el modo Nuevo para el valor de elemento Default), la fecha y hora se representan en formato universal: M/D/A hh:mm a.m./p.m. Se corresponde con el tipo de datos datetime de SQL y está representado por la clase SPFieldDateTime.

  • File   Contiene un archivo. Se corresponde con el tipo de datos uniqueidentifier de SQL.

  • GridChoice   Contiene una escala de clasificación para encuestas. Se corresponde con el tipo de datos ntext de SQL y está representado por la clase SPFieldRatingScale.

  • Guid   Permite identificadores únicos globales (GUID). Se corresponde con el tipo de datos uniqueidentifier de SQL.

  • Integer   Permite valores enteros positivos o negativos. Los atributos Commas y NegativeFormat se utilizan para especificar el formato de valores. Se corresponde con el tipo de datos int de SQL.

  • Lookup  Se comporta de forma muy similar a un campo Choice, excepto en que las opciones disponibles proceden de otra lista en lugar de ser una selección de valores codificados. Los atributos List y ShowField se pueden usar para campos de búsqueda. Este campo se puede ordenar y agrupar. Para ordenar y agrupar, use el valor DisplayField (Title, de forma predeterminada) en lugar de la clave externa almacenada en la lista. Corresponde al tipo de datos SQL int y se representa con la clase SPFieldLookup.

  • LookupMulti Un campo Lookup que puede contener más de un valor. Tipo primario: Lookup.

  • ModStat   Contiene el estado de aprobación del contenido. Entre los posibles valores se incluyen Approved (predeterminado), Rejected y Pending (almacenados en la base de datos como 0, 1 o 2, respectivamente). Corresponde al tipo de datos SQL int.

  • MultiChoice especifica un campo Choice que implementa casillas de verificación y permite al usuario seleccionar varios valores. Se corresponde con el tipo de datos ntext de SQL y está representado por la clase SPFieldMultiChoice.

  • MultiColumn   Un campo Note que emula un campo que contiene varios valores. Para obtener un ejemplo de un tipo de campo de varias columnas, consulte Procedimiento para crear una definición de tipo de campo personalizado. Para obtener información sobre campos de varias columnas, consulte Clases de campos de varias columnas personalizados. Tipo primario: Note.

  • Note   Permite al usuario introducir múltiples líneas de texto. Este campo no se puede ordenar ni agrupar. Todo el texto se define como caracteres ASCII convencionales sin formato HTML. Todo lo que parece formato HTML o una dirección URL se encierra entre comillas (por ejemplo, Server.HTMLEncode) para que parezca texto convencional. El control para editar este formato es un simple bloque TEXTAREA. Use el atributo NumLines para especificar el número de líneas para mostrar. Corresponde al tipo de datos SQL ntext y se representa con la clase SPFieldMultiLineText.

  • Number   Permite introducir un número de punto flotante. Este campo se puede ordenar y agrupar. Los números introducidos se analizan de acuerdo con la configuración regional actual para puntos decimales y separadores de miles. Los números negativos se pueden indicar entre paréntesis o mediante un símbolo negativo. Los atributos siguientes pueden utilizarse junto con el atributo Number para especificar el formato de los números: Decimals, Div, Max, Min, Mult, y Percentage.

    Corresponde al tipo de datos SQL float y se representa con la clase SPFieldNumber.

  • PageSeparator   Inserta un salto de página en una lista de encuesta. Se representa con la clase SPFieldPageSeparator.

  • Recurrence   Se usa para editar y definir el modelo de periodicidad de un elemento en una lista de eventos. Corresponde al tipo de datos SQL bit.

  • Text   Una sola línea de texto escrito en un cuadro de edición. Este campo se puede ordenar y agrupar. Use el atributo MaxLength para establecer un número máximo de caracteres permitidos. Corresponde al tipo de datos SQL nvarchar y se representa con la clase SPFieldText.

  • ThreadIndex   Contiene el identificador que indica la posición relativa de un mensaje en un subproceso de conversación. Corresponde al tipo de datos SQL varbinary.

  • Threading   El tipo de campo Threading se usa en la creación y presentación de vistas similares a discusiones encadenadas. Cualquier lista puede contener una columna de subprocesamiento, pero cuando se usa se genera una interfaz de usuario especial. (Nunca se muestra como un campo modificable estándar en un formulario ni como una columna normal en una vista). Si se realiza una ordenación en un campo de subprocesos, se obtiene como resultado una exploración previa al orden de todos los registros de una relación principal-secundario. Esto se lleva a cabo guardando la concatenación de la fecha de creación y número de identificador de todos los registros principales de un registro concreto. Se corresponde con el tipo de datos varchar de SQL.

  • URL   se utiliza para crear un hipervínculo de forma libre. Un campo de dirección URL se muestra como <A HREF="URL">Descripción</A>. Si no se proporciona ninguna descripción, se muestra como <A HREF="Dirección URL">Dirección URL</A>. El propio texto de la dirección URL se almacena en la tabla de direcciones URL (DocMd), que almacena todas las direcciones URL en bases de datos de SharePoint en el servidor. Esto se hace de modo que todas las direcciones URL que son locales en el servidor se puedan actualizar mediante la corrección de vínculos cuando se mueve su destino. Cuando se elimina un registro que contiene un campo de dirección URL, también se elimina de la tabla de direcciones URL el registro correspondiente al que se hace referencia. Este campo se puede ordenar y agrupar. (La ordenación se define según la descripción textual en lugar del contenido de la dirección URL; si no se da ninguna descripción, se ordena del mismo modo que en blanco). Cuando Type es URL, se puede usar el atributo LinkType para especificar el tipo de vínculo. Se corresponde con el tipo de datos de SQL nvarchar, representado por la clase SPFieldUrl.

  • User   Un campo Lookup que hace referencia a la tabla de base de datos UserInfo. Se corresponde con el tipo de datos int de SQL y está representado por la clase SPFieldUser.

  • UserMulti   Un campo User que puede contener más de un valor. Tipo primario: LookupMulti.

  • WorkflowEventType   Especifica un tipo de evento de flujo de trabajo tal y como está representado por la enumeración SPWorkflowHistoryEventType. Tipo primario: Integer.

  • WorkflowStatus   Especifica el estado del flujo de trabajo tal y como lo representa la enumeración SPWorkflowStatus. Se corresponde con el tipo de datos nvarchar de SQL.

UniqueId

Text opcional. No pensado para utilizarlo directamente desde el código.

UnlimitedLengthInDocumentLibrary

Boolean opcional. TRUE para permitir una longitud de campo ilimitada en las bibliotecas de documentos.

URLEncode

Boolean opcional. TRUE para convertir caracteres especiales, como espacios, al formato UTF-8 con comillas; por ejemplo, %c3%ab para el carácter ë.

URLEncodeAsURL

Boolean opcional. Igual que URLEncode, pero TRUE para especificar que la cadena que se va a codificar es un componente de la ruta de una dirección URL para que no se codifiquen las barras diagonales ("/").

UserSelectionMode

Text opcional. Especifica si se pueden seleccionar sólo los nombres de usuarios individuales en un campo de usuario de un formulario de elementos, o si se pueden seleccionar los nombres de los individuos y grupos. Los valores siguientes son posibles:

0 - Solamente se pueden seleccionar los nombres de las personas.

1 - Se pueden seleccionar tanto los nombres de las personas como los de los grupos.

UserSelectionScope

Integer opcional. Especifica un ámbito para seleccionar los nombres de usuario en un campo de usuario de un formulario de elementos. Si el valor es 0, no hay ninguna restricción a un grupo de SharePoint. Si el valor es mayor que 0, la selección del usuario está restringida a los miembros del grupo cuyo identificador es igual al valor que se especifica de SharePoint.

Version

Text opcional.

Viewable

Boolean opcional. TRUE para especificar que el campo se agrega a la vista predeterminada. El valor predeterminado es TRUE.

WebId

Text opcional.

Width

Integer opcional. Especifica el ancho en píxeles de las imágenes que se muestran a los usuarios en la lista Información del usuario.

WikiLinking

Boolean opcional. TRUE para especificar que vínculos wiki, que aparecen como corchetes dobles ([[…]]), se traducen en vínculos HTML, que utilizan la etiqueta <a>.

XName

Text opcional. Se usa internamente en formularios XML para identificar campos que se han agregado, eliminado o modificado. Este atributo no es de uso público.

Elementos secundarios

CHOICES, Customization, Default, DefaultFormula, DisplayBidiPattern, DisplayPattern, FieldRefs, Formula, FormulaDisplayNames, MAPPINGS, Validation

Elementos primarios

Fields, ProjectedFields

Repeticiones

Mínimo: 0

Máximo: sin límite cuando el elemento primario es Fields. Cuando el elemento primario es ProjectedFields el máximo es la diferencia entre el número máximo de campos permitidos en la lista principal que se va a consultar y el número de campos que ya están en la lista.

Comentarios

Para crear una definición de campos personalizados para una definición de lista que está basada en un tipo de campo predeterminado SharePoint Foundation, use el elementoField (List - Definition) dentro de un archivo Schema.xml. Para crear una definición de campos personalizados como una característica conectable que se basa en un tipo de campo predeterminado y que puede volver a usarse a través de sitios web y las listas dentro de una colección de sitios, use el elemento Campo (Campo) para definir una columna de sitio personalizada  . Para crear un tipo de campo personalizado que implementa una clase personalizada para la validación de datos especiales y la representación de campo, use el elemento Campo (Tipos de campo).

Se puede hacer referencia a campos a partir de las definiciones de vista, así como de las expresiones de los elementos de representación de campos calculados. Use el elemento Campo (Vista) para obtener un valor de campo con formato para mostrarlo dentro de una vista, y el elemento Columna (Vista) para obtener los datos sin formato del campo. La sintaxis para hacer referencia a un campo es la siguiente:

<Field Name="FieldName"/>

De manera predeterminada, el campo se representa con los atributos predeterminados de la definición de dicho campo, tal como se especifica en la tabla anterior. Cualquiera de los atributos de campo se puede invalidar en el marcado CAML del atributo FieldRef, que invalida la definición dada para el propio campo. (El atributo Type de un campo no puede modificarse).

Se puede usar <Property Select="DisplayName"/> para visualizar el nombre para mostrar definido por el usuario de un campo.

Dentro de una enumeración de elementos de Fields, se puede omitir el atributo Name. Para algunas referencias de campo, se puede tener acceso a los datos sin procesar almacenados para el campo mediante <Column/>.

Algunas propiedades de los campos de formularios y de determinados aspectos de la interfaz de usuario de creación se pueden representar a través del elemento Property, por ejemplo, <Property Select="Description"/> or <Property Select="Type"/>. Estos elementos simplemente recuperan el valor de cualquier atributo de campo o elemento secundario (Property) por su nombre.

Además de los tipos anteriores, los siguientes campos predefinidos se usan con el elemento Field.

Nombre

Descripción

Created

Un campo que contiene un valor DateTime que especifica la hora en que se creó el elemento (en UTC).

CreatedBy

Un campo que contiene un valor Lookup que hace referencia a la tabla UserInfo e indica el usuario que creó el elemento.

Edit

Un campo calculado (con ningún esquema adicional) que contiene un hipervínculo al formulario para editar un elemento. Este campo hace referencia a la página para editar el elemento y al campo Id. para identificarlo.

ID

Un tipo de campo Counter que está asociado con todos los elementos de todas las listas. El identificador identifica de forma unívoca al elemento de lista en las direcciones URL y en formularios POST durante la edición. Al especificar New como el valor del atributo ID en el comando Cmd=Save, se crea un elemento en lugar de modificar un elemento actual.

Modified

Un campo que contiene un valor DateTime que especifica la hora en que el elemento se modificó por última vez (en UTC). La hora Modified también se usa como una especie de campo Version. La fecha de última modificación de un elemento siempre se registra cuando se está editando un elemento existente. Si no coincide con la fecha de modificación actual, el servidor provoca un error de edición y devuelve un error al usuario, con un vínculo a los datos actuales en el servidor (que se abre en una nueva ventana), para que los valores publicados puedan copiarse del formulario antiguo al nuevo.

ModifiedBy

Un campo que contiene un valor Lookup a la tabla UserInfo que indica el último usuario que modificó el elemento.

Title

Nombre para mostrar genérico de cada elemento. Puede tener un nombre para mostrar diferente en las distintas listas pero el mismo nombre de campo interno de Title. El título es el texto predeterminado que se muestra para campos Lookup para listas.

LinkTitle

Un campo calculado que muestra hipervínculos a elementos, que contiene los textos de los títulos y genera direcciones URL (y nuevas referencias a iconos) a los elementos. No hay ningún almacenamiento adicional para este campo; se basa en los campos de identificador y título para representar su interfaz de usuario.

Nota

Los campos devueltos en una enumeración Fields se ven afectados por el modo de presentación. Los campos que están marcados con el atributo Hidden nunca se devuelven. Los campos que están marcados con el atributo ReadOnly no se devuelven si se va a representar un formulario (si se llama a Fields desde un elemento ListForm). Los campos que están marcados con el atributo ShowInNewForm no se devuelven en los modos de presentación NEW o PREVIEWNEW. Los campos marcados con el atributo ShowInFileDlg no se devuelven al representar el formulario de diálogo NewForm.

Ejemplo

En el siguiente ejemplo se usa el elemento Field para especificar las opciones de una lista denominada Area list (lista de área).

<Field Type="Choice" BaseType="Text" Name="Area">
  <CHOICES>
    <CHOICE>Views</CHOICE>
    <CHOICE>Site Design</CHOICE>
    <CHOICE>Layouts</CHOICE>
    <CHOICE>Schema Design</CHOICE>
    <CHOICE>Fields</CHOICE>
    <CHOICE>Forms</CHOICE>
    <CHOICE>Projects</CHOICE>
    <CHOICE>Inter-Team Issues</CHOICE>
    <CHOICE>Schedule</CHOICE>
    <CHOICE>Spec</CHOICE>
    <CHOICE>Headcount</CHOICE>
    <CHOICE>Misc</CHOICE>
  </CHOICES>
</Field>

Vea también

Referencia

Elemento Column (Vista)

Elemento Column2 (Vista)

Elemento Field (Campo)

Elemento Field (Tipos de campo)

Elemento Field (esquema de propiedades de tipos de campos)

Elemento Field (DeploymentManifest - DeploymentFieldTemplate)

Elemento Field (DeploymentManifest - FieldDataCollection)

Elemento Field (DeploymentManifest - SPFieldCollection)

Elemento Field (Vista)

Elemento Field (Site)