Share via


Attribute (objeto del Diseñador de modelos)

Actualizado: 17 de julio de 2006

El objeto Attribute define un elemento de una entidad. Este objeto también hereda propiedades del objeto Field.

Propiedades

Nombre Cardinalidad Tipo Descripción

Name

1

String

El nombre del elemento. Tenga en cuenta que esta cadena es obligatoria si el atributo no tiene una expresión.

DataType

1

DataTypeEnum

El tipo de datos del atributo. Si hay una expresión, el valor de DataType debe coincidir con el valor de DataType de la expresión.

Nullable

0-1

Boolean

Indica si el atributo puede tener un valor NULL.

Expression

0-1

Object

La expresión utilizada para calcular el valor del atributo. Se debe devolver un valor escalar.

SortDirection

0-1

Enum

La dirección predeterminada por la que se ordena en este atributo. De manera predeterminada, la dirección es ascendente.

Width

0-1

Integer

Ancho de columna predeterminado, en caracteres, para mostrar el atributo. El valor debe ser superior a 0. El valor predeterminado se basa en DataType y tiene los valores siguientes: Boolean: 6, DateTime: 10, Integer: 8, Decimal: 8, Float: 8, String: 20, Binary: 1023, EntityKey: 128.

Alignment

0-1

Enum

La alineación de caracteres predeterminada. El valor predeterminado es General. Otros valores posibles son Left, Center o Right.

MimeType

0-1

String

El tipo MIME del atributo. Para los atributos no binarios, este valor se omite. No se puede especificar una cadena vacía.

DataCulture

0-1

Language

Indica la referencia cultural que se utiliza para las operaciones donde la referencia cultural es relevante, como aplicar formato a datos numéricos con un símbolo de moneda. El atributo de referencia cultural no se utiliza para formatos de visualización simples, como formatos de fecha o de número. Si no se especifica, el valor predeterminado de DataCulture es el valor de referencia cultural del modelo utilizado en Model.Culture.

DiscourageGrouping

0-1

Boolean

Indica si la aplicación cliente debe evitar que el usuario utilice este atributo para agrupar. DiscourageGrouping debe establecerse en campos con valores únicos, como números de teléfono. Si el atributo es un atributo de identificación o de clave de la entidad, la aplicación cliente agrupa en los atributos de clave de la entidad.

EnableDrillthrough

0-1

Boolean

Indica si la aplicación cliente debe proporcionar un vínculo de obtención de detalles desde el atributo a la entidad que lo contiene.

Format

0-1

String

Especifica la cadena de formato predeterminada de .NET Framework que se utiliza para dar formato al valor del atributo. Además de los valores de los formatos .NET Framework estándar, se admiten las cadenas de formato siguientes:

Cadenas de formato para números enteros de fecha

  • ddd: abreviatura del día de la semana
  • dddd: nombre completo del día de la semana
  • MMM: abreviatura del mes
  • MMMM: nombre completo del mes

Cadenas de formato para valores booleanos

  • truefalse: "True" y "False"
  • yesno: "Yes" y "No"

Cadenas de formato personalizado para valores booleanos

Las cadenas de formato personalizado se presentan como "truevalue;falsevalue".

  • true: "True"
  • false: "False"
  • yes: "Yes"
  • no: "No"
  • " y ': los caracteres escritos entre comillas simples o dobles se copian literalmente en la cadena de resultado y no afectan al formato.
  • Carácter de escape \: el carácter siguiente se considera un carácter literal, no un especificador de formato.

ContextualName

0-1

Enum

Define la forma en que la aplicación cliente debe generar un nombre contextual para el atributo cuando se alcanza la entidad mediante el uso de una función. El enumerador puede ser uno de los tres valores siguientes: Attribute, Merge o Role. El valor predeterminado del enumerador es Attribute, que utiliza el nombre del atributo como nombre contextual. Si especifica Merge, los nombres de la función y del atributo se combinan y se utilizan como nombre contextual. Si este atributo es el único que identifica a la entidad, al especificar Role se utiliza el nombre de la función como nombre contextual. Si no es el único atributo que identifica a la entidad, Role se trata como Merge.

IsAggregate

0-1

Boolean

Indica si el atributo es un agregado que se puede calcular en el contexto de no sólo la entidad que lo contiene, sino también de cualquier otra entidad para la que haya una relación uno a varios en la entidad que lo contiene. Si no se establece, el atributo se trata como escalar. IsAggregate sólo puede ser True para los atributos con expresiones no delimitadas.

IsFilter

0-1

Boolean

Indica que el atributo está destinado a usarse como filtro con nombre. Sólo puede ser True para atributos booleanos.

OmitSecurityFilters

0-1

Boolean

Indica que la expresión de este atributo debe calcularse sin filtros de seguridad. Se usa habitualmente en los casos en que los datos de detalle tienen que protegerse mediante filtros de seguridad, pero los datos de agregado son públicos. Esta propiedad se omite cuando el atributo no tiene una expresión.

DefaultAggregateAttributeID

0-1

String

Id. de un atributo que es el agregado predeterminado de este atributo. Esta cadena debe ser el Id. de una variación de este atributo. Esta cadena no se permite si IsAggregate es True. Si el atributo está oculto, se omite el valor.

ValueSelection

0-1

Enum

Determina el comportamiento de la aplicación cliente en la selección de valores del atributo, según el número de valores únicos esperados. Hay tres opciones disponibles: None, Dropdown y List. De manera predeterminada, se selecciona None, que requiere que el usuario escriba un valor. Cuando se especifica Dropdown, los valores únicos se muestran en una lista desplegable simple. Cuando se especifica List, los valores únicos se muestran en la interfaz de usuario como una lista. Si IsAggregate es True, este atributo se omite.

Binding

0-1

Object

El objeto de base de datos que representa este campo. Este objeto es obligatorio si el atributo no tiene una expresión. El enlace debe realizarse a una columna en la tabla a la que la entidad que la contiene está enlazada, o a la columna a la que la entidad está enlazada.

Notas

  • En el Generador de informes, un atributo se denomina campo.
  • Para evitar que se recuperen todos los valores únicos de un campo en una interfaz de selección de valores, como el cuadro de diálogo Filtrar datos o el área de parámetros, asegúrese de establecer la propiedad ValueSelection en None. Se pedirá al usuario que escriba un valor.
  • Cuando se utilicen funciones que pueden devolver Null, la propiedad Nullable del atributo debe establecerse en True.
  • Cuando la propiedad ValueSelection está establecida en List, el usuario del Generador de informes visualiza todos los valores como listas ordenadas. No obstante, cuando se crea una condición de filtro solicitada, es posible que la lista de parámetros de valores no esté ordenada porque la consulta semántica no realiza operaciones de ordenación en consultas de valores de parámetros. Si la lista de valores de parámetros no está ordenada y desea que lo esté, intente crear un índice en el campo de la base de datos subyacente; de este modo, se suele ordenar la lista.
  • Para crear un grupo en la entidad en lugar de en el campo cuando se agrega el campo al diseño de informe del Generador de informes, puede establecer la propiedad DiscourageGrouping en True para el campo. Esta propiedad sólo se debe establecer en True para los atributos únicos.

Para obtener más información acerca de los valores de enumeración válidos, vea Tipos de datos del Diseñador de modelos.

Vea también

Conceptos

Diseñador de modelos
Propiedades de los objetos del Diseñador de modelos
Creación de informes ad hoc con modelos de informe
Trabajar con el Diseñador de modelos

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión Historial

17 de julio de 2006

Contenido nuevo:
  • Notas: controlar instancias únicas de un campo.

14 de abril de 2006

Contenido nuevo:
  • Se agregó contenido a la sección Notas.