Elemento Field (Campo)

Artículo
09/24/2014

Última modificación: jueves, 20 de mayo de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios

Define una columna de sitio.

<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>

Atributos

Atributo	Descripción
Aggregation	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 Agregar valores. count Contar la cantidad de valores. average Buscar el promedio de los valores. min Buscar el valor mínimo. max Buscar el valor máximo. merge Combinar los valores. plaintext Convertir el contenido de texto del nodo en texto sin formato. first Aplicar la promoción o la disminución de nivel de la propiedad al primer elemento de la colección. last Aplicar la promoción o la disminución de nivel de la propiedad 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 disminución de nivel de propiedades en documentos XML, vea Uso de tipos de contenido para especificar propiedades de documentos 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 las páginas de edición de campos para identificar el campo y su finalidad. Por ejemplo, el campo LinkTitle tiene la información de creación "(vincular al elemento)". Usualmente, este atributo se usa si existe un campo con el mismo nombre pero 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 Saka Era 15 Chino lunar 14 Coreano y japonés lunar 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 (árabe lunar) 5 Coreano (era de Tangún) 4 Era de Taiwán 3 Era del emperador japonés 1 Gregoriano 0 Sin un tipo especificado
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.
Commas	Boolean opcional. TRUE si se usan comas como separador de miles.
Customization	Text opcional. Proporciona la capacidad de agregar propiedades personalizadas a los tipos de campo personalizados.
Decimals	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.
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 en 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.
DisplaceOnUpgrade	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 es de 255 caracteres. El valor puede ser una referencia a un recurso en el formato $Resources:String. Para obtener más información, vea el tema sobre la 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 la edición solo de la fecha (la parte de la hora se establece en 12:00 a. m. para todos los valores editados). DateTime Mostrar y editar la fecha y hora del día (valor predeterminado). ISO8601 Mostrar la fecha y hora en el formato de hora ISO8601 convertido al formato de hora universal coordinada (UTC): AAAA - MM - DDTHH:MM:SSZ. Este formato se usa para las propiedades de documento en 2007 Microsoft Office system y 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 los 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 los campos de dirección URL, este atributo se puede establecer en Hyperlink (predeterminado), que muestra la dirección URL como una etiqueta <A> normal, o en Image, que muestra la dirección URL como <IMG SRC="URL" ALT="Description">.
FromBaseType	Boolean opcional. Este atributo está desusado. En su lugar se usa el 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 con el fin de que se muestren como texto en el explorador. Los caracteres que se podrían confundir con las 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 sin 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 aún pueden desactivarlo. inactive Se escriben caracteres sin el IME, aunque los usuarios aún pueden activarlo.
Indexed	Boolean opcional. TRUE si la columna está indizada por usarse 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 reescribirá el código HTML del campo para garantizar que no interfiera con la representación de la página adyacente.
IsRelationship	Boolean opcional. TRUE si el campo es devuelto por el método GetRelatedFields() 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.
List	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.
Name	Text obligatorio. El nombre interno del campo. El nombre debe ser único en relación con un conjunto de campos de una lista o un sitio web. De ser necesario, SharePoint Foundation modificará el valor para garantizar su exclusividad. De lo contrario, el nombre no cambia durante la duración de la definición del campo.
NegativeFormat	Text opcional. Especifica cómo indicar valores negativos. Puede establecerse en uno de los siguientes valores: MinusSign Usar un signo menos como prefijo. Parens Colocar entre paréntesis.
Node	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. Sin embargo, tenga en cuenta que si el campo existente es de solo lectura, o si está sellado, el campo que se va a activar 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 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 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 Uso de tipos de contenido para especificar propiedades de documentos XML.
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.
Presence	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 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 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 Uso de tipos de contenido para especificar propiedades de documentos XML.
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 se incluye este atributo, SharePoint Foundation trata la columna como si el 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 de 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 proporciona un campo con un valor en los parámetros de envío de formulario, se muestra el texto de campo obligatorio estándar o un mensaje especificado (es decir, mediante las etiquetas <ErrorText>) 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.
RowOrdinal	Integer opcional. Especifica la ubicación de la base de datos del campo.
Sealed	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 (como notas o comentarios) en otra línea. 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.
Sortable	Boolean opcional. TRUE si los valores del campo se pueden almacenar.
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 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ó. Puede usar este valor más adelante 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.
Type	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 de la vista previa técnica de Microsoft SharePoint Foundation 2010, el atributo Type tiene un significado distinto y sólo 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 día completo. Corresponde al tipo de datos bit de SQL. Attachments 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 ó 1). Este campo se puede ordenar y agrupar. Corresponde al tipo de datos bit de SQL y está representado por la clase SPFieldBoolean. Calculated Especifica un campo cuyo valor se calcula en función de otras columnas. Corresponde al tipo de datos sql_variant de SQL y está representado por la clase SPFieldCalculated. Choice Permite al usuario especificar un conjunto predeterminado de valores que se pueden usar para ingresar 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 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 un valor del campo Title con un hipervínculo. Está 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 Identificadores de tipo de contenido. Corresponde al tipo de datos varbinary de SQL. Counter Por lo general, se usa solo para el campo del 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 de área de reuniones; hace referencia específicamente al tipo de campo de la casilla de verificación usada en los formularios Nuevo elemento y Editar elemento para crear un sitio de área de reuniones para el elemento. Corresponde al tipo de datos bit de SQL y está representado por la clase SPFieldCrossProjectLink. Currency Permite que se escriba un valor de moneda. Cada campo de moneda está vinculado a la moneda de la 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 de SQL y está representado por la clase SPFieldCurrency. DateTime Permite el almacenamiento de una fecha completa u hora del día. Use el atributo Format para especificar el formato de la fecha y use el atributo StorageTZ para determinar cómo se almacenarán los valores de fecha y hora. Este campo se puede ordenar y agrupar. Para el modo de presentación, el orden del formato de la fecha deriva de la configuración regional ("M/D/A" o "D/M/A"). En el modo de edición (o en el modo nuevo para el valor del elemento Default), la fecha y hora se representan en formato universal: M/D/A hh:mm a. m./p. m. Corresponde al tipo de datos datetime de SQL y está representado por la clase SPFieldDateTime. File 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 ntext de SQL y está representado por la clase SPFieldRatingScale. Guid Permite los identificadores únicos globales (GUID). Corresponde al tipo de datos uniqueidentifier de SQL. Integer Permite los 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. Lookup Se comporta de manera muy similar a un campo Choice, excepto que las opciones disponibles provienen 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 de SQL y está representado por la clase SPFieldLookup. LookupMulti Campo Lookup 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 las casillas de verificación y permite al usuario seleccionar varios valores. Corresponde al tipo de datos ntext de SQL y está representado por la clase SPFieldMultiChoice. MultiColumn Un campo Note que emula un campo con varios valores. Para consultar un ejemplo de un tipo de campo multicolumn, vea Procedimiento para crear una definición de tipo de campo personalizado. Para obtener información sobre campos multicolumn, vea Clases de campos de varias columnas personalizados. Tipo primario: Note. Note 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 ntext de SQL y está representado por la clase SPFieldMultiLineText. Number Permite la escritura de 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 de SQL y está representado por la clase SPFieldNumber. PageSeparator Inserta un salto de página en una lista de encuesta. Está representado por la clase SPFieldPageSeparator. Recurrence Se usa para editar y definir el patrón de periodicidad para un elemento en una lista de eventos. Corresponde al tipo de datos bit de SQL. 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 la cantidad máxima de caracteres permitidos. Corresponde al tipo de datos nvarchar de SQL y está representado por 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 varbinary de SQL. Threading El tipo de campo Threading se usa en la creación y presentación de vistas de tipo discusión con subprocesos. 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 el campo de subproceso se ordena, se devuelve un recorrido en preorden de todos los registros de una relación de elementos primarios y secundarios. 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. URL Se usa para crear un hipervínculo de forma libre. Un campo de URL se muestra como <A HREF="URL">Descripción</A>. Si no se proporciona ninguna descripción, se muestra como <A HREF="URL">URL</A>. 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 lleva a cabo para que todas las direcciones URL locales del servidor se puedan actualizar a través de la corrección de vínculo cuando se mueve el destino. Cuando se elimina un registro con un campo de dirección URL, también se eliminará el registro correspondiente al que se hace referencia en la tabla de direcciones URL. Este campo se puede ordenar y agrupar. (El orden se define según la descripción de texto en lugar del contenido de la dirección URL. Si no se especifica ninguna descripción, lo ordena como si estuviera en blanco). Cuando Type es URL, el atributo LinkType se puede usar para especificar el tipo de vínculo. Corresponde al tipo de datos nvarchar de SQL y está representado por la clase SPFieldUrl. User Un campo Lookup que hace referencia a la tabla de la base de datos de información del usuario. Corresponde al tipo de datos int de SQL y está representado por la clase SPFieldUser. UserMulti Campo User que puede contener más de un valor. Tipo de elemento primario: LookupMulti. WorkflowEventType Especifica un tipo de evento de flujo de trabajo como representado por la enumeración SPWorkflowHistoryEventType. Tipo de elemento primario: Integer. WorkflowStatus Especifica un estado de flujo de trabajo como 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 usuarios. 1: se pueden seleccionar los nombres de personas 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.
Viewable	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 entre corchetes dobles ([[…]]), se traducen en vínculos HTML, que usan la etiqueta <a>.
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 primarios

Elements

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. En Microsoft Visual Studio, la finalización de instrucciones indica erróneamente que solo se necesitan tres de los atributos cuando, en realidad, se requieren los cinco.

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="https://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

Compartir a través de

Elemento Field (Campo)

Atributos

Elementos secundarios

Elementos primarios

Comentarios

Ejemplo

Vea también

Referencia

Conceptos

Otros recursos

Recursos adicionales