Freigeben über


Attribute-Objekt (Modell-Designer)

Das Attribute-Objekt definiert ein Element innerhalb einer Entität. Außerdem erbt dieses Objekt die Eigenschaften des Field-Objekts.

Eigenschaften

Name

Kardinalität

Typ

Beschreibung

Name

1

String

Der Name des Elements. Beachten Sie, dass es sich hierbei um eine erforderliche Zeichenfolge handelt, wenn das Attribut nicht über einen Ausdruck verfügt.

DataType

1

DataTypeEnum

Der Datentyp des Attributs. Wenn ein Ausdruck vorhanden ist, muss der DataType-Wert mit dem DataType-Wert des Ausdrucks übereinstimmen.

Nullable

0-1

Boolean

Gibt an, ob das Attribut einen Nullwert aufweisen kann.

Expression

0-1

Object

Der Ausdruck, der zur Berechnung des Werts für das Attribut verwendet wird. Ein Skalarwert muss zurückgegeben werden.

SortDirection

0-1

Enum

Die Standardrichtung, nach der sortiert wird, wenn für dieses Attribut eine Sortierung durchgeführt wird. Standardmäßig wird aufsteigend sortiert.

Width

0-1

Integer

Die Standardspaltenbreite in Zeichen zum Anzeigen des Attributs. Der Wert muss größer als 0 (null) sein. Der Standardwert hängt von DataType ab und weist die folgenden Werte auf: Boolean: 6, DateTime: 10, Time: 8, Integer: 8, Decimal: 8, Float: 8, String: 20, Binary: 1023, EntityKey: 128.

Alignment

0-1

Enum

Die Standardzeichenausrichtung. Die Standardeinstellung lautet Allgemein. Weiterhin sind die Werte Links, Zentriert oder Rechts möglich.

MimeType

0-1

String

Der MIME-Typ des Attributs. Für nicht binäre Attribute wird dieser Wert ignoriert. Sie dürfen keine leere Zeichenfolge angeben.

DataCulture

0-1

Language

Gibt die für kulturbezogene Vorgänge zu verwendende Kultur an, z. B. durch Formatieren numerischer Daten mit einem Währungssymbol. Dieses Kulturattribut wird nicht für die einfache Anzeigeformatierung, z. B. für Datums- oder numerische Formate, verwendet. Wenn die Kultur nicht angegeben wird, entspricht der Standardwert von DataCulture dem in Model.Culture verwendeten Kulturwert des Modells.

DiscourageGrouping

0-1

Boolean

Gibt an, ob in der Clientanwendung dem Benutzer von der Gruppierung für dieses Attribut abgeraten werden soll. DiscourageGrouping sollte für Felder mit eindeutigen Werten, z. B. Telefonnummern, festgelegt werden. Handelt es sich bei dem Attribut um ein Schlüssel- oder ein identifizierendes Attribut der Entität, gruppiert die Clientanwendung stattdessen die Schlüsselattribute der Entität.

EnableDrillthrough

0-1

Boolean

Gibt an, ob die Clientanwendung einen Drillthroughlink von diesem Attribut zu der Entität bereitstellen soll, in der das Attribut enthalten ist.

Format

0-1

String

Gibt die standardmäßig verwendete .NET Framework-Formatzeichenfolge an, mit der der Wert für das Attribut formatiert wird. Neben den standardmäßigen .NET Framework-Formaten werden die folgenden Formatzeichenfolgen unterstützt:

Formatzeichenfolgen für ganze Zahlen

  • ddd: Wochentag, Abkürzung

  • dddd: vollständiger Wochentag

  • MMM: Monat, Abkürzung

  • MMMM: vollständiger Monatsname

Formatzeichenfolgen für boolesche Werte

  • truefalse: "True" und "False"

  • yesno: "Yes" und "No"

Benutzerdefinierte Formatzeichenfolgen für boolesche Werte

Benutzerdefinierte Formatzeichenfolgen weisen das Format "truevalue;falsevalue" auf.

  • true: "True"

  • false: "False"

  • yes: "Yes"

  • no: "No"

  • " und '. Zeichen, die in einfache oder doppelte Anführungszeichen eingeschlossen sind, werden buchstabengetreu in die Ergebniszeichenfolge kopiert und wirken sich nicht auf die Formatierung aus.

  • \ (Escapezeichen). Das einem Escapezeichen folgende Zeichen wird als Literalzeichen und nicht als Formatbezeichner behandelt.

ContextualName

0-1

Enum

Definiert, wie die Clientanwendung einen kontextbezogenen Namen für das Attribut generieren soll, wenn die Entität mithilfe einer Rolle erreicht wird. Der Enumerator kann einen der folgenden drei Werte aufweisen: Attribute, Merge oder Role. Standardmäßig wird Attribute als Enumeratorwert verwendet, d. h., der Attributname wird als kontextbezogener Name verwendet. Wenn Sie Merge angeben, werden der Attributname und der Rollenname zusammengeführt und als kontextbezogener Name verwendet. Ist dieses Attribut das einzige identifizierende Attribut der Entität, wird bei Angabe von Role der Rollenname als kontextbezogener Name verwendet. Wenn das Attribut nicht das einzige identifizierende Attribut der Entität ist, hat Role dieselbe Wirkung wie Merge.

IsAggregate

0-1

Boolean

Gibt an, ob dieses Attribut ein Aggregat ist, das nicht nur im Kontext der Entität, die das Attribut enthält, berechnet werden kann, sondern auch im Kontext aller anderen Entitäten, für die in der Entität, die das Attribut enthält, eine 1:n-Beziehung besteht. Bei fehlender Festlegung wird das Attribut als Skalar behandelt. IsAggregate kann nur für Attribute mit nicht verankerten Ausdrücken True sein.

IsFilter

0-1

Boolean

Gibt an, dass dieses Attribut als ein benannter Filter verwendet werden soll. Kann nur für boolesche Attribute den Wert True besitzen.

OmitSecurityFilters

0-1

Boolean

Gibt an, dass der Ausdruck für dieses Attribut berechnet werden soll, ohne dass Sicherheitsfilter hinzugefügt werden. Wird üblicherweise für Fälle verwendet, in denen Detaildaten auf der Grundlage von Sicherheitsdaten gesichert werden müssen, Aggregatdaten jedoch öffentlich sind. Diese Eigenschaft wird ignoriert, wenn das Attribut nicht über einen Ausdruck verfügt.

DefaultAggregateAttributeID

0-1

String

Die ID eines Attributs, die das Standardaggregat für dieses Attribut ist. Bei dieser Zeichenfolge muss es sich um die ID einer Variante dieses Attributs handeln. Diese Zeichenfolge ist nicht zulässig, wenn IsAggregate auf True festgelegt ist. Ist das Attribut ausgeblendet, wird der Wert ignoriert.

ValueSelection

0-1

Enum

Bestimmt das Verhalten der Clientanwendung bei der Auswahl der Werte für das Attribut auf der Grundlage der erwarteten Anzahl eindeutiger Werte. Es stehen drei Optionen zur Verfügung: None, Dropdown und List. Standardmäßig ist None ausgewählt, sodass der Benutzer einen Wert eingeben muss. Wenn Dropdown angegeben ist, werden die eindeutigen Werte in einer einfachen Dropdownliste angezeigt. Wenn List angegeben ist, werden die eindeutigen Werte auf der Benutzeroberfläche als eine Liste angezeigt. Wenn IsAggregate den Wert True aufweist, wird dieses Attribut ignoriert.

Binding

0-1

Object

Das Datenbankobjekt, das dieses Feld repräsentiert. Dieses Objekt ist erforderlich, wenn das Attribut nicht über einen Ausdruck verfügt. Die Bindung muss entweder an eine Spalte in der Tabelle gebunden sein, an die die Entität, die das Attribut enthält, gebunden ist, oder an die Spalte, an die die Entität gebunden ist.

Hinweise

  • Im Berichts-Generator werden Attribute als Felder bezeichnet.

  • Um zu verhindern, dass alle eindeutigen Werte eines Felds in einer Wertauswahlschnittstelle wie dem Dialogfeld Daten filtern oder dem Parameterbereich abgerufen werden, müssen Sie die ValueSelection-Eigenschaft auf None festlegen. Der Benutzer muss einen Wert eingeben.

  • Wenn Sie Funktionen verwenden, die Null zurückgeben können, müssen Sie die Nullable-Eigenschaft des Attributs auf True festlegen.

  • Wenn die ValueSelection-Eigenschaft auf List festgelegt ist, werden alle Werte dem Benutzer des Berichts-Generators als sortierte Liste angezeigt. Wenn jedoch eine veranlasste Filterbedingung erstellt wird, ist die Liste der Parameterwerte möglicherweise nicht sortiert, da die semantische Abfrage keine Parameterwertabfragen sortiert. Wenn die Liste der Parameterwerte nicht sortiert ist, Sie dies aber wünschen, können Sie versuchen, einen Index für das Feld in der zugrunde liegenden Datenbank zu erstellen. Dadurch wird häufig die Liste sortiert.

  • Wenn Sie eine Gruppe in einer Entität statt in einem Feld beim Hinzufügen des Felds zum Berichtslayout des Berichts-Generators erstellen möchten, müssen Sie die DiscourageGrouping-Eigenschaft für das Feld auf True festlegen. Diese Eigenschaft sollte nur für eindeutige Attribute auf true festgelegt werden.

Weitere Informationen zu gültigen Enumerationswerten finden Sie unter Modell-Designer-Datentypen.