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. |
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
Formatzeichenfolgen für boolesche Werte
Benutzerdefinierte Formatzeichenfolgen für boolesche Werte Benutzerdefinierte Formatzeichenfolgen weisen das Format "truevalue;falsevalue" auf.
|
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. |
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.