Elemento Field (Field)

  • Artículo

Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Define una columna de sitio.

Definición

<Field
  Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  AllowDeletion="TRUE" | "FALSE"
  AllowDuplicateValues="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"
  Commas="TRUE" | "FALSE"
  Customization=Text
  Decimals="Integer"
  DefaultListField="TRUE" | "FALSE"
  Description="Text"
  Dir="Text"
  DisplaceOnUpgrade="TRUE" | "FALSE"
  DisplayImage="Text"
  DisplayName="Text"
  DisplayNameSrcField="Text"
  DisplaySize=Integer
  Div="Number"
  EnableLookup="TRUE" | "FALSE"
  ExceptionImage="Text"
  FieldRef="Text"
  FillInChoice="TRUE" | "FALSE"
  Filterable="TRUE" | "FALSE"
  FilterableNoRecurrence="TRUE" | "FALSE"
  ForcedDisplay="Text"
  Format="DateOnly | DateTime | TimeOnly | EventList | ISO8601 | MonthDayOnly | MonthYearOnly | ISO8601Basic | ISO8601Gregorian | ISO8601BasicDateOnly | DropDown | RadioButtons | HyperLink | Image | TRUE | FALSE"
  FromBaseType="TRUE" | "FALSE"
  Group="Text"
  HeaderImage="Text"
  Height="Integer"
  Hidden="TRUE" | "FALSE"
  HTMLEncode="TRUE" | "FALSE"
  ID="Text"
  IMEMode="active | 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"
  List="Text"
  Max="Number"
  MaxLength="Integer"
  Min="Number"
  Mult="TRUE" | "FALSE"
  Name="Text"
  NegativeFormat="MinusSign" | "Parens"
  Node="Text"
  NoEditFormBreak="TRUE" | "FALSE"
  NumLines="Integer"
  Overwrite="TRUE" | "FALSE"
  OverwriteInChildScopes="TRUE" | "FALSE"
  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="Restrict | Cascade | None"
  RenderXMLUsingPattern="TRUE" | "FALSE"
  Required="TRUE" | "FALSE"
  RestrictedMode="TRUE" | "FALSE"
  ResultType="Text"
  RichText="TRUE" | "FALSE"
  RichTextMode="Text"
  RowOrdinal="Integer"
  Sealed="TRUE" | "FALSE"
  SeperateLine="TRUE" | "FALSE"
  SetAs="Text"
  ShowAddressBookButton="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"
  Viewable="TRUE" | "FALSE"
  Width="Integer"
  WikiLinking="TRUE" | "FALSE"
  XName="Text">
</Field>

Elementos y atributos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Description
Agregación Text opcional. Se usa en un campo agregado en un formulario XML para especificar la función que se debe implementar en una colección de valores o elementos devuelta por una expresión XPath. Si usa el atributo Node para especificar una expresión XPath que devuelva una colección de valores, también puede incluir un atributo Aggregation que especifique la acción que se debe realizar en el conjunto de valores devuelto. Esta acción puede ser una función de agregación o una indicación del elemento concreto dentro de la colección.

Entre los valores posibles se encuentran:

  • sum: agregue los valores.
  • count: cuente el número de valores.
  • average: busque el promedio de los valores.
  • min: busque el valor mínimo.
  • max: busque el valor máximo.
  • merge: combine los valores.
  • texto sin formato: convierte el contenido de texto del nodo en texto sin formato.
  • first: aplique la promoción y degradación de propiedades al primer elemento de la colección.
  • last: aplique la promoción y degradación de propiedades al último elemento de la colección.

Para obtener más información sobre cómo se usan los atributos Node, PIAttribute, PITarget, PrimaryPIAttribute y PrimaryPITarget para la promoción y degradación de propiedades en documentos XML, vea Uso de tipos de contenido para especificar propiedades de documento XML.
AllowDeletion Boolean opcional. TRUE si se puede eliminar el campo.
AllowDuplicateValues Boolean opcional. Especifica si se permiten valores duplicados en un campo de lista determinado. Al establecer este valor en false, se impide la entrada de valores duplicados y se consigue que el campo se comporte como una clave principal. Es True si se permiten los valores duplicados en el campo, de lo contrario, es false. El valor predeterminado es true.
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 el control de versiones está habilitado en la lista, TRUE si el texto solo se puede anexar a texto 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 en Integer, que almacena valores como números enteros, o en Text (predeterminado), que almacena valores como texto. No puede crear campos de opción de tipo base de números enteros.
CalType Integer opcional. Especifica el tipo de calendario. Entre los valores posibles se incluyen los siguientes:
  • 16: Era Saka
  • 15: Lunar chino
  • 14: Lunar coreano y japonés
  • 12: Francés transliterado gregoriano
  • 11: Inglés transliterado gregoriano
  • 10: Árabe gregoriano
  • 9: Francés gregoriano de Oriente Medio
  • 8: Hebreo (lunar)
  • 7: Tailandés
  • 6: Hijri (árabe lunar)
  • 5: Era tangun coreana
  • 4: Era de Taiwán
  • 3: Era emperador japonés
  • 1: Gregoriano
  • 0: No se especificó ningún tipo
CanToggleHidden Boolean opcional. TRUE si el campo se puede ocultar a través de la interfaz de usuario.
Classinfo Text opcional. Especifica una clase de hoja de estilos en cascada (CSS) que se debe usar en el campo en la vista de tabla estándar. Si se establece, 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 del campo. Debe ser un nombre válido en la base de datos subyacente y debe ser idéntico al nombre usado en la tabla de base de datos. Si no se especifica, el servidor genera un nombre de columna que no provoca un conflicto con los nombres de columna existentes y que solo contiene caracteres compatibles con Microsoft SQL Server.
Comas Boolean opcional. TRUE si se usan comas como separador de miles.
Personalización Text opcional. Proporciona la capacidad de agregar propiedades personalizadas a los tipos de campo personalizados.
Decimales Integer opcional. Determina la cantidad de decimales que se deben mostrar. El valor que se muestra se redondea hacia arriba para coincidir con la precisión de presentación; por ejemplo, 1,05 se muestra como 1,1 cuando se redondea a una única posición decimal.
DefaultListField Boolean opcional. Obtiene un valor que especifica si se debe mostrar el formulario Editar propiedades de un archivo cuando el archivo está cargado en una biblioteca de documentos. Es True si el campo que se va a agregar a una biblioteca no tiene un formulario Editar propiedades visible; en caso contrario, es false. El valor predeterminado es false.
Descripción 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 forma predeterminada, los campos de Microsoft SharePoint Foundation no tienen descripciones.
Dir Text opcional. Especifica la dirección del texto de un campo que admite el orden de lectura bidireccional. Los valores posibles son LTR (de izquierda a derecha) RTL (derecha a izquierda) y none.
DesplazareOnUpgrade Boolean opcional. Si ya existe una definición de campo para el campo, TRUE para forzar las actualizaciones de las propiedades de campo con los valores especificados en esta definición.
DisplayImage Text opcional. Especifica el nombre de un icono que se muestra para la columna.
DisplayName Text opcional. El nombre mostrado de un campo. No hay ninguna restricción sobre el uso de espacios. La longitud máxima son 255 caracteres. El valor puede ser una referencia a un recurso en el formato $Resources:String. Para obtener más información, vea Localización de soluciones de SharePoint.

El usuario puede editar el nombre para mostrar, el cual puede cambiar después de la creación inicial del campo. El nombre se usa como un encabezado de columna cuando el campo se muestra en una vista de tabla y como una etiqueta de formulario cuando el campo se muestra en un formulario.
DisplayNameSrcField Text opcional. Por lo general, se usa para un campo calculado que debe tener el mismo nombre que otro campo. Si se modifica el campo de origen y un usuario cambia el nombre para mostrar, también se cambiará el nombre para mostrar de este campo. Esta cadena hace referencia al nombre del otro campo.
DisplaySize Integer opcional.
Div Number opcional. Un factor de escala que se usa en una división antes de mostrar un número. El número para mostrar es N * Mult / Div (redondeado hacia arriba para coincidir con el número especificado en Decimals).
EnableLookup Boolean opcional. TRUE para permitir valores de búsqueda en el campo.
ExceptionImage Text opcional. Se usa en un tipo de campo Recurrence para especificar el nombre de un archivo de imagen que se debe usar para las excepciones.
FieldRef Text opcional. En un campo de búsqueda secundario, especifica el identificador del campo de búsqueda principal del que depende. El valor debe ser la representación de cadena de un GUID sin llaves.
FillInChoice Boolean opcional. TRUE si el campo permite a los usuarios rellenar los 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 la forma en que FilterableNoRecurrence se configure.
ForcedDisplay Text opcional. Especifica el texto que se mostrará en lugar del valor real del campo. Este atributo se usa en las encuestas para evitar que aparezca el nombre de usuario.
Format Text opcional. Especifica el formato que se usará para los valores numéricos.

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

  • DateOnly: mostrar (y permitir modificaciones en) solo la parte de fecha (la parte de hora se establece en 12:00 A.M. para todos los valores editados).
  • DateTime: muestra y edita tanto la fecha como la hora del día (valor predeterminado).
  • ISO8601: Mostrar fecha y hora en formato de hora ISO8601 convertido al formato de hora universal coordinada (UTC): AAAA-MM-DDTHH:MM:SSZ. Este es el formato usado para las propiedades de documento en el sistema de Microsoft Office 2007, así como para el formato de intercambio estándar que se usa en SharePoint Foundation entre los formularios New y Edit y el servidor.
  • ISO8601Basic: Use la forma abreviada de formatos de fecha y hora 8601: AAAAMMDDTHHMMSSZ. Este formato se usa para vCard o iCal.

En los campos de opción, este atributo se puede establecer en Dropdown (predeterminado), que proporciona opciones de edición mediante una selección desplegable, o en RadioButtons, que ofrece opciones mediante un grupo de botones de radio.

En el caso de los campos URL, este atributo se puede establecer en Hyperlink (valor predeterminado), que muestra la dirección URL como una etiqueta normal <a> , o en 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 debe usar como un encabezado en el campo.
Height Integer opcional. Especifica la altura en píxeles de las imágenes que se muestran a los usuarios en la lista de información de usuarios.
Hidden Boolean opcional. Si es TRUE, el campo está oculto por completo de la interfaz de usuario. Si ReadOnly se establece en TRUE, significa que el campo no se muestra en los formularios nuevos o de edición, pero aún se puede incluir en las 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 obligatorio. Identifica de manera única el campo. El valor debe ser la representación de cadena de un GUID incluido entre llaves ({}).
IMEMode Text opcional. Especifica la preferencia de modo del Editor de métodos de entrada (IME) que se va a usar para el campo. El IME permite la conversión de pulsaciones de teclas entre lenguajes cuando un sistema de escritura tiene más caracteres de los que se pueden codificar para el teclado.

Entre los valores posibles se encuentran:

  • auto: no se usa. Para especificar el modo del IME, establezca el valor de la propiedad IMEMode en una cadena vacía ("").
  • active: todos los caracteres se escriben a través del IME, pero los usuarios pueden desactivar el IME.
  • inactivo: los caracteres se escriben sin el IME, aunque los usuarios todavía pueden activar el IME.
Indexed Boolean opcional. TRUE si la columna está indizada por usarse en filtros de vista.

Nota: Aunque puede indexar una columna Lookup para mejorar el rendimiento, el uso de una columna lookup indizada para evitar superar el umbral de vista de lista no funciona. Para evitar superar el umbral de vista de lista, use otro tipo de columna como el índice principal o secundario.
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 método GetRelatedFields() devuelve este campo de otra lista.
JoinColName Text opcional. Este atributo solo se define para los campos de búsqueda. Es muy similar a ColName, excepto que indica el nombre de la columna que se usa en la construcción JOIN de SQL entre las listas locales y externas. Normalmente, este valor no debe personalizarse. En la actualidad, se usa solo en el esquema de campo de determinados campos integrados y de tipo base para indicar las búsquedas en la tabla de direcciones URL (DocMd), que se une en la columna UrlID.
JoinRowOrdinal Integer opcional. No está destinado para uso directo desde el código.
JoinType Text opcional. Especifica el tipo de construcción JOIN que se usará en el campo. Entre los valores posibles se incluyen INNER, LEFTOUTER y RIGHTOUTER.
LCID Integer opcional. El atributo LCID se puede usar para especificar el país o la región cuyo formato de moneda se usa, por ejemplo, 1033 para los Estados Unidos.

Dos casos especiales están relacionados con el formato de símbolo del euro. Si LCID=-1 (0xFFFFFFF), el símbolo del euro se agrega como un prefijo al número. Si el LCID=-2 (0xFFFFFFE), el símbolo del euro se agrega como un sufijo al número. La cantidad de dígitos decimales es 2, aunque el atributo Decimals del campo puede invalidarlos. El símbolo de moneda del euro es igual a 0x20AC en UCS-2.
Lista Text opcional. Se usa para identificar la lista que es el destino de un campo de búsqueda (Type="Lookup").

Si la lista de objetivo ya existe, el valor del atributo List debe ser la representación de cadena del GUID (incluidas las llaves) que identifica la lista de objetivo. Si el destino es la misma lista a la que pertenece el campo, puede especificar "Self".

Si la lista de objetivo no existe todavía, el valor del atributo List puede ser una dirección URL relativa a Web, como "Listas" o "Mi lista", pero solo si se crea la lista de objetivo en la misma característica que crea el campo de búsqueda. En este caso, el valor del atributo List en el elemento Field debe ser idéntico al valor del atributo Url en el elemento ListInstance que crea la lista de objetivo.
Max Number opcional. Especifica el valor máximo permitido para el campo.
MaxLength Integer opcional. Especifica el número máximo de caracteres permitido en un valor de campo. Los formularios de edición se ajustan para aplicar este valor, que se valida en el cliente. Si el usuario intenta especificar un número de caracteres superior al número permitido establecido por MaxLength, aparece un mensaje de error.
Min Number opcional. Especifica el valor mínimo permitido para el campo.
Mult Boolean opcional. TRUE para permitir que un campo de búsqueda tenga varios valores. El valor predeterminado es FALSE.
Nombre Text obligatorio. El nombre interno del campo. El nombre debe ser único con respecto al conjunto de campos de una lista o sitio web. SharePoint Foundation modificará el valor si es necesario para garantizar su exclusividad; de lo contrario, no cambia durante la duración de la definición de campo.
NegativeFormat Text opcional. Especifica cómo indicar valores negativos. Puede establecerse en uno de los siguientes valores:
  • MinusSign: use el signo menos como prefijo.
  • Analizadores: rodear con paréntesis.
Nodo Text opcional. Se usa en los formularios XML, este atributo es obligatorio para todos los campos excepto para los vínculos de instrucción de procesamiento (PI) y especifica la expresión XPath de un nodo que se promueve.
NoEditFormBreak Boolean opcional. TRUE para impedir que un salto de línea se agregue entre los campos en el formulario del elemento nuevo o editar el formulario del elemento. Algunos tipos de campo, como, por ejemplo, un campo de texto enriquecido, proporcionan el espaciado de manera predeterminada y este atributo permite controlar el espacio extra que se genera.
NumLines Integer opcional. Recomienda la cantidad de líneas (filas) que se deben mostrar en un bloque TEXTAREA durante la edición. Esto es simplemente una sugerencia de la interfaz de usuario de cliente, ya que no hay un límite exigido para la cantidad de líneas de texto que se pueden editar.
Overwrite Boolean opcional. Especifica si la definición de campo para un campo nuevo que se activa en un sitio (SPWeb) sobrescribe la definición de un campo existente cuando el nuevo tiene el mismo identificador de campo que uno existente. True si el nuevo campo sobrescribe el campo existente con el mismo identificador de campo; en caso contrario false. El valor predeterminado es false.

Nota: Si el campo existente es de solo lectura o si está sellado, el campo que se está activando no lo sobrescribirá, incluso si este atributo está establecido en true.
OverwriteInChildScopes Boolean opcional. Indica si se debe sobrescribir la definición del campo especificado cuando se aprovisiona el campo en una colección de sitios y la definición de campo ya existe en el sitio web secundario de dicha colección de sitios. True si la definición de campo se debe sobrescribir; en caso contrario, false. El valor predeterminado es False.
Percentage Boolean opcional. TRUE si se muestra el valor 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 (que especifica el atributo PITarget) que se usa como el valor de la columna. Se usa para la promoción y disminución de nivel 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 cómo se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para la promoción y disminución de nivel de propiedades en documentos XML, vea Using Content Types to Specify XML Document Properties.
PITarget Text opcional. Especifica la instrucción de procesamiento de documentos en la que se almacena el valor de la columna en los documentos de este tipo de contenido. Se usa para la promoción y disminución de nivel 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 cómo se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para la promoción y disminución de nivel de propiedades en documentos XML, vea Using Content Types to Specify XML Document Properties.
PrependId Boolean opcional. Los campos de búsqueda que pueden tener varios valores usan este atributo. Especifique TRUE para mostrar el identificador de elemento de un elemento de destino y el valor del campo de destino en los formularios Nuevo elemento y Editar elemento.
Presencia Boolean opcional. TRUE si hay información de usuario para el campo.
PrimaryKey Boolean opcional. TRUE si el campo es la clave principal de la relación entre la lista y otra lista.
PrimaryPIAttribute Text opcional. Se usa para la promoción y disminución de nivel de propiedades en documentos XML. Especifica un atributo alternativo en la instrucción de procesamiento de documentos (que especifica el atributo PrimaryPITarget), que se usará como el valor de columna. Si se especifica el atributo PrimaryPIAttribute, también se debe especificar el atributo PrimaryPITarget. Si se especifica, SharePoint Foundation usa estos valores antes de los especificados en los atributos PITarget y PIAttribute .

Para obtener más información sobre cómo se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para la promoción y disminución de nivel de propiedades en documentos XML, vea Using Content Types to Specify XML Document Properties.
PrimaryPITarget Text opcional. Especifica una instrucción de procesamiento de documentos alternativa en la que se almacena el valor de columna 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 usa estos valores antes de los especificados en los atributos PITarget y PIAttribute .

Para obtener más información sobre cómo se usan los atributos Node, PIAttribute, PITarget, Primary PIAttribute y PrimaryPITarget para la promoción y disminución de nivel de propiedades en documentos XML, vea Using Content Types to Specify XML Document Properties.
ReadOnly Boolean opcional. Si es TRUE, el campo no se muestra en los formularios nuevos o de edición, pero se puede incluir en las vistas. Además, si ReadOnly se establece en TRUE, oculta el campo de las páginas de Configuración del sitio para la administración de columnas de sitio y los tipos de contenido. Si el atributo Hidden se establece en TRUE, oculta por completo el campo de la interfaz de usuario. Si no incluye este atributo, SharePoint Foundation trata la columna como si este atributo estuviera establecido en False.
ReadOnlyEnforced Boolean opcional. TRUE para especificar que el usuario no puede cambiar el campo por ningún medio y que únicamente el sistema puede cambiarlo.
RelationshipDeleteBehavior Text opcional. Especifica una restricción de eliminación de un campo de búsqueda. Para obtener más información, vea la enumeración SPRelationshipDeleteBehavior .

Para una columna de sitio, el valor no debe ser Cascade ni Restrict. Puede ser None (el valor predeterminado) o el atributo se puede omitir.

Si especifica un valor distinto que None, también debe especificar TRUE para el atributo Indexed y FALSE para el atributo Mult.
RenderXMLUsingPattern Boolean opcional. Se usa en campos calculados para determinar el formato de presentación. Si es TRUE, los valores se representan en función del modelo de presentación del campo calculado, en lugar del valor de columna 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 altura, pero si el atributo no está establecido en TRUE, se muestra solo la primera referencia del campo: ancho. Si se establece en TRUE, se muestra el formato ancho x altura.
Required Boolean obligatorio. Si es TRUE, el campo no debe tener asignado un valor vacío. Si no se especifica ningún valor de campo en una entrada de formulario, el texto de campo obligatorio estándar o un mensaje especificado explícitamente (es decir, a través <ErrorText> de etiquetas) se muestra en el formulario de error. Únicamente el cliente controla la validación (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 (por ejemplo, tablas, imágenes o hipervínculos) ni permitir que se pegue texto con formato en el campo.
ResultType Text opcional. Especifica el tipo de datos de los valores devueltos por el campo.
RichText Boolean opcional. TRUE si el campo muestra formato de texto enriquecido.
RichTextMode Text opcional. Una de las opciones de la enumeración RichTextMode.
RowOrdinal Integer opcional. Especifica la ubicación de la base de datos del campo.
Sellado Boolean opcional. Si se establece el atributo en TRUE para un campo, el campo se marca como inamovible. La página Cambiar columna no tiene ningún botón Eliminar. Los usuarios no pueden eliminar el campo.
SeparateLine Boolean opcional. Se usa internamente para admitir la representación de un campo (por ejemplo, Notas o Comentarios) en una línea independiente. Este atributo no está destinado para uso público.
SetAs No está destinado para uso directo desde el código.
ShowAddressBookButton No está destinado para uso directo desde el código.
ShowField Text opcional. Cuando el atributo Type es "Lookup", el valor del atributo ShowField especifica el nombre interno del campo de destino en el que se buscará. Si no se especifica ningún valor, se muestra el texto del hipervínculo desde el campo Title del registro en la lista de objetivo.

Se permiten los siguientes tipos de campo como destino de un campo de búsqueda: Counter, DateTime, Number y Text. El tipo de campo Computed puede ser un destino si las búsquedas están habilitadas. Para obtener más información, vea la propiedad EnableLookup de la clase SPFieldComputed . El tipo de campo Calculated puede ser un destino si el resultado es texto. Para obtener más información, vea la propiedad OutputType de la clase SPFieldCalculated**.
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 solo es válido para los campos de los esquemas de biblioteca de documentos. Si es FALSE, el campo no aparece en el cuadro de diálogo de propiedades para guardar los formularios que aparece cuando se guarda desde aplicaciones cliente. Por ejemplo, el campo Title tiene este atributo ya que está establecido 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 la lista.
ShowInNewForm Boolean opcional. Si es FALSE, el campo no aparece en una enumeración Fields cuando el modo de presentación se establece en New. Los campos con esta configuración no aparecen en la página Elemento nuevo predeterminada de una lista determinada. En concreto, se usa para ocultar campos en la página para cargar documentos a la biblioteca de documentos.
ShowInVersionHistory Boolean opcional. TRUE para mostrar la columna en la página para ver las versiones del elemento de lista.
ShowInViewForms Boolean opcional. TRUE para especificar que el campo se muestra en las páginas que se usan para ver datos de lista.
Se puede ordenar Boolean opcional. TRUE si los valores del campo se pueden almacenar.
SourceID Text opcional. Contiene el espacio de nombres que define el campo, como http://schemas.microsoft.com/sharepoint/v3 o el GUID de la lista en la que se creó el campo personalizado.
StaticName Text opcional. Contiene un nombre interno del campo que puede no ser único en una colección de campos. Sin embargo, a diferencia del atributo Name, que puede modificarse para garantizar su exclusividad, el valor del atributo StaticName se asigna al campo tal como se definió. Más adelante puede usar este valor en el código para obtener una referencia al campo llamando al método TryGetFieldByStaticName .
StorageTZ Especifica cómo se almacenan los valores de fecha y hora. Cuando StorageTZ se establece en UTC, la fecha y hora se tratan como hora universal coordinada (UTC). Omita el atributo StorageTZ para indicar que un valor de fecha y hora se refiere a un tiempo "abstracto", que indica que la fecha y hora se almacenan en la base de datos tal y como las escribió el usuario, sin conversión o almacenamiento de la zona horaria local.
Stripws Boolean opcional. TRUE si se eliminan los espacios en blanco del principio y 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 es TRUE, el campo solo puede tener valores Text.
Title Text opcional. Contiene el título del campo que se muestra en la interfaz de usuario.
Tipo Text obligatorio. El tipo de datos del campo (a menos que el elemento Field sea un elemento secundario de ProjectedFields).

Nota: En la versión preliminar de tecnología de Microsoft SharePoint Foundation 2010, el atributo Type tiene un significado diferente y solo un valor posible ("Lookup") cuando es un elemento secundario de ProjectedFields. Para obtener más información sobre este uso de Type, vea ProjectedFields Element (View).

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

  • AllDayEvent: especifica un evento de todo el día. Corresponde al tipo de datos bit de SQL.
  • Datos adjuntos: almacena las direcciones URL de los datos adjuntos. Corresponde al tipo de datos bit de SQL.
  • Boolean: se usa para almacenar un valor TRUE/FALSE (almacenado en la base de datos como 0 o 1). Este campo se puede ordenar y agrupar. Corresponde al tipo de datos SQL de bits y se representa mediante la clase SPFieldBoolean .
  • Calculado: especifica un campo cuyo valor se calcula en función de otras columnas. Corresponde al tipo de datos sql sql_variant y se representa mediante la clase SPFieldCalculated**.
  • Opción: permite al usuario especificar un conjunto predeterminado de valores que se pueden usar para escribir datos en el campo. Los tipos Choice y Lookup son los campos más importantes para la organización y agrupación. Los atributos BaseType y Format se pueden usar en los campos de opción. Este campo se puede ordenar y agrupar. Cuando se proporciona un valor para un campo de opción, ese valor se usa como el valor enviado para la selección del campo. Cuando no se especifica ningún valor, esa opción se envía como el valor de texto de opción. En todos los casos, el valor de texto de la opción es lo que se muestra en la interfaz de usuario (lista desplegable o texto del botón de radio). El orden en que las opciones aparecen en la interfaz de usuario de edición es siempre el orden en que se especifican los elementos en el elemento CHOICES. Use el tipo MultiChoice para especificar un campo Choice que implemente las casillas de verificación y permita al usuario seleccionar varios valores. Corresponde al tipo de datos sql nvarchar y representa la clase SPFieldChoice .
  • Calculado: especifica un campo que depende de otro campo para su contenido. Por ejemplo, un campo LinkTitleNoMenu equivale a rodear un valor del campo Title con un hipervínculo. Representado por la clase SPFieldComputed .
  • ContentTypeId: contiene un identificador de tipo de contenido. Para obtener información acerca del formato de los identificadores de tipo de contenido, vea Content Type IDs. Corresponde al tipo de datos varbinary de SQL.
  • Contador: por lo general, solo se usa para el campo de identificador interno. Su valor de entero se establece automáticamente para que sea único con respecto a todos los elementos de la lista actual. El tipo Counter siempre es de solo lectura y no se puede establecer a través de un envío de formulario. El campo se puede ordenar, pero no agrupar. Corresponde al tipo de datos int de SQL.
  • CrossProjectLink: se usa para conectar un evento en una lista de SharePoint con un sitio del área de trabajo de reunión; hace referencia específicamente al tipo de campo de la casilla usada en formularios Nuevo y Editar elemento para crear un sitio del área de trabajo de reunión para el elemento. Corresponde al tipo de datos SQL de bits y se representa mediante la clase SPFieldCrossProjectLink .
  • Moneda: permite especificar 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 una moneda de una configuración regional específica. Los atributos Decimals, Max y Min se pueden usar en los tipos de moneda. Este campo se puede ordenar y agrupar. Corresponde al tipo de datos float SQL y se representa mediante la clase SPFieldCurrency .
  • DateTime: permite el almacenamiento de una fecha o hora del día completa. Use el atributo Format para especificar el formato de fecha y use el atributo StorageTZ para determinar cómo se almacenan los valores de fecha y hora. Este campo se puede ordenar y agrupar. Para el modo de visualización, el orden de formato de fecha se deriva de la configuración regional ("M/D/Y" o "D/M/Y"). En el modo de edición (o en el modo Nuevo para el valor de elemento Predeterminado ), las fechas y horas se representan en formato universal: M/D/Y hh:mm am/pm. Corresponde al tipo de datos sql datetime y representa la clase SPFieldDateTime .
  • Archivo: contiene un archivo. Corresponde al tipo de datos uniqueidentifier de SQL.
  • GridChoice: contiene una escala de clasificación para encuestas. Corresponde al tipo de datos sql ntext y se representa mediante la clase SPFieldRatingScale .
  • Guid: permite identificadores únicos globales (GUID). Corresponde al tipo de datos uniqueidentifier de SQL.
  • Integer: permite valores enteros positivos o negativos. Los atributos Commas y NegativeFormat se usan para especificar el formato de número entero. Corresponde al tipo de datos int de SQL.
  • Búsqueda: se comporta de forma muy similar a un campo Choice , salvo que las opciones disponibles proceden de otra lista en lugar de ser una selección de valores codificada de forma rígida. Los atributos List y ShowField se pueden usar en los campos de búsqueda. Este campo se puede ordenar y agrupar. Para ordenar y agrupar, use el valor DisplayField (Title, de manera predeterminada) en vez de la clave externa almacenada en la lista. Corresponde al tipo de datos int SQL y se representa mediante la clase SPFieldLookup .
  • LookupMulti: un campo de búsqueda que puede contener más de un valor. Tipo de elemento primario: Lookup.
  • ModStat: contiene el estado de aprobación de contenido. Los valores posibles incluyen Approved (predeterminado), Rejected y Pending (almacenados en la base de datos como 0, 1 ó 2, respectivamente). Corresponde al tipo de datos int de SQL.
  • MultiChoice: especifica un campo Choice que implementa casillas de verificación y permite al usuario seleccionar varios valores. Corresponde al tipo de datos sql ntext y se representa mediante la clase SPFieldMultiChoice .
  • MultiColumn: campo de nota que emula un campo que contiene varios valores. Para consultar un ejemplo de un tipo de campo multicolumn, vea Custom Field Type Definition. Para obtener información sobre campos multicolumn, vea Custom Multicolumn Field Classes. Tipo primario: Note.
  • Nota: Permite a los usuarios escribir varias líneas de texto. Este campo no se puede ordenar o agrupar. Todo el texto está definido como caracteres ASCII convencionales sin formato HTML. Todo lo que se parece a formato HTML o a una dirección URL se encierra entre comillas (por ejemplo, Server.HtmlEncode) para que se parezca a texto convencional. El control de edición de este formato es un simple bloque TEXTAREA. Use el atributo NumLines para especificar la cantidad de líneas que desea mostrar. Corresponde al tipo de datos sql ntext y se representa mediante la clase SPFieldMultiLineText .
  • Número: permite especificar un número de punto flotante. Este campo se puede ordenar y agrupar. Los números especificados se analizan de acuerdo con la configuración actual de la configuración regional de los separadores de decimales y miles. Para indicar que un número es negativo, se puede colocar el número entre paréntesis o se puede usar un símbolo de negativo. Los siguientes atributos se pueden usar 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 float SQL y se representa mediante la clase SPFieldNumber .
  • PageSeparator: inserta un salto de página en una lista de encuestas. Representado por la clase SPFieldPageSeparator .
  • Periodicidad: se usa para editar y definir el patrón de periodicidad de un elemento de una lista de eventos. Corresponde al tipo de datos bit de SQL.
  • Texto: una sola línea de texto escrita en un cuadro de edición. Este campo se puede ordenar y agrupar. Use el atributo MaxLength para establecer la cantidad máxima de caracteres permitidos. Corresponde al tipo de datos sql nvarchar y se representa mediante la clase SPFieldText .
  • ThreadIndex: contiene el identificador que indica la posición relativa de un mensaje dentro de un subproceso de conversación. Corresponde al tipo de datos varbinary de SQL.
  • Subprocesamiento: el tipo de campo Threading se usa en la creación y visualización de vistas de discusión en subproceso. Cualquier lista puede contener una columna de subproceso, pero se genera una interfaz de usuario especial cuando se usa. (Nunca se muestra como un campo editable estándar en un formulario ni como una columna normal en una vista). Si se realiza una ordenación en un campo de subproceso, se devuelve un recorrido de orden previo de todos los registros de una relación primario-secundario. Para ello, se debe guardar la concatenación de la fecha de creación y el número de identificación de todos los registros primarios de un registro determinado. Corresponde al tipo de datos varchar de SQL.
  • DIRECCIÓN URL: se usa para crear un hipervínculo de forma libre. Un campo URL se muestra como Descripción. Si no se proporciona ninguna descripción, se muestra como dirección URL. El texto de la dirección URL se almacena en la tabla de direcciones URL (DocMd), que almacena todas las direcciones URL de las bases de datos de SharePoint en el servidor. Esto se hace para que las direcciones URL que son locales en el servidor se puedan actualizar a través de la corrección de vínculos cuando se mueva su destino. Cuando se elimina un registro con un campo de dirección URL contenido en él, también se elimina el registro al que se hace referencia correspondiente de la tabla de direcciones URL. 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 proporciona ninguna descripción, ordena lo mismo que en blanco). Cuando Type es URL, el atributo LinkType se puede usar para especificar el tipo de vínculo. Corresponde al tipo de datos sql nvarchar y se representa mediante la clase SPFieldUrl .
  • Usuario: campo de búsqueda que hace referencia a la tabla de base de datos UserInfo. Corresponde al tipo de datos int SQL y se representa mediante la clase SPFieldUser .
  • UserMulti: campo De usuario que puede contener más de un valor. Tipo de elemento primario: LookupMulti.
  • WorkflowEventType: especifica un tipo de evento de flujo de trabajo representado por la enumeraciónSPWorkflowHistoryEventType . Tipo de elemento primario: Integer.
  • WorkflowStatus: especifica el estado del flujo de trabajo representado por la enumeración SPWorkflowStatus . Corresponde al tipo de datos nvarchar de SQL.
UniqueId Text opcional. No está destinado para uso directo desde el código.
UnlimitedLengthInDocumentLibrary Boolean opcional. TRUE para permitir que la longitud del campo sea ilimitada en bibliotecas de documentos.
URLEncode Boolean opcional. TRUE para convertir caracteres especiales, como espacios, en formato UTF-8 entre comillas, por ejemplo, %c3%ab para el carácter ë.
URLEncodeAsURL Boolean opcional. Como URLEncode, pero TRUE para especificar que la cadena que se codificará es un componente de la ruta de acceso de una dirección URL con el fin de que las barras diagonales ("/") no sean codificadas.
UserSelectionMode Text opcional. Especifica si se pueden seleccionar solo los nombres de usuarios individuales en un campo de usuario en un formulario de elementos, o si se pueden seleccionar los nombres de personas y grupos. Los siguientes valores son posibles:
  • 0: Solo se pueden seleccionar los nombres de las personas.
  • 1: Se pueden seleccionar los nombres de individuos y grupos.
UserSelectionScope Integer opcional. Especifica un ámbito para la selección de nombres de usuario en un campo de usuario de un formulario de elementos. Si es valor es 0, no hay ninguna restricción para un grupo de SharePoint. Si el valor es mayor que 0, la selección del usuario está restringida a los miembros del grupo de SharePoint cuyo identificador coincide con el valor especificado.
Visible Boolean opcional. Es TRUE para agregar el campo a la vista predeterminada. El valor predeterminado es TRUE.
Width Integer opcional. Especifica el ancho en píxeles de las imágenes que se muestran a los usuarios en la lista de información de usuarios.
WikiLinking Boolean opcional. TRUE para especificar que los vínculos wiki, que aparecen en forma de corchetes dobles ([[...]]), se traducen en vínculos HTML, que usan la <a> etiqueta .
XName Text opcional. Se usa internamente en formularios XML para identificar los campos agregados, eliminados o modificados. Este atributo no está destinado para uso público.

Elementos secundarios

Elementos principales

Comentarios

Importante

Al definir un campo personalizado, debe especificar los atributos ID, Type, Name, DisplayName y Group para que el campo aparezca correctamente en Microsoft SharePoint Foundation. La finalización de instrucciones en Microsoft Visual Studio indica erróneamente que solo se necesitan los tres primeros atributos cuando, de hecho, los cinco son necesarios.

Ejemplo

En el siguiente ejemplo se muestra un manifiesto de elemento para una característica que crea tres columnas de sitio.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
  <Field ID="{060E50AC-E9C1-4D3C-B1F9-DE0BCAC300F6}"
          Name="Amount"
          DisplayName="Amount"
          Type="Currency"
          Decimals="2"
          Min="0"
          Required="FALSE"
          Group="Financial Columns" />

  <Field ID="{943E7530-5E2B-4C02-8259-CCD93A9ECB18}"
          Name="CostCenter"
          DisplayName="Cost Center"
          Type="Choice"
          Required="FALSE"
          Group="Financial Columns">
    <CHOICES>
      <CHOICE>Administration</CHOICE>
      <CHOICE>Information</CHOICE>
      <CHOICE>Facilities</CHOICE>
      <CHOICE>Operations</CHOICE>
      <CHOICE>Sales</CHOICE>
      <CHOICE>Marketing</CHOICE>
    </CHOICES>
  </Field>

  <Field ID="{1511BF28-A787-4061-B2E1-71F64CC93FD5}"
          Name="DateOpened"
          DisplayName="Date Opened"
          Type="DateTime"
          Format="DateOnly"
          Required="FALSE"
          Group="Financial Columns">
    <Default>[today]</Default>
  </Field>
</Elements>

Vea también