Facetfacet

Eine Facette wird verwendet, um einer Eigenschafts Definition für primitive Typen Details hinzuzufügen.A facet is used to add detail to a primitive type property definition. Eine Eigenschaften Definition enthält Informationen zum Eigenschaftentyp. häufig sind jedoch weitere Details erforderlich.A property definition contains information about the property type, but often more detail is necessary. Ein Entitätstyp in einem konzeptionellen Modell könnte z. B. über eine Eigenschaft vom Typ String verfügen, deren Wert nicht auf NULL festgelegt werden kann.For example, an entity type in a conceptual model might have a property of type String whose value cannot be set to null. Mit Facets können Sie diese Detailebene angeben.Facets allow you to specify this level of detail.

In der nachfolgenden Tabelle werden die im EDM unterstützten Facets beschrieben.The table below describes the facets that are supported in the EDM.

Hinweis

Die genauen Werte und Verhalten von Facets werden von der Laufzeitumgebung bestimmt, die eine EDM-Implementierung verwendet.The exact values and behaviors of facets are determined by the run-time environment that uses an EDM implementation.

FacetFacet BeschreibungDescription BetrifftApplies to
Collation Gibt die bei Vergleich- und Sortiervorgängen zu verwendende Sortierreihenfolge für die Werte der Eigenschaft an.Specifies the collating sequence (or sorting sequence) to be used when performing comparison and ordering operations on values of the property. String
ConcurrencyMode Gibt an, dass der Eigenschaftswert für Prüfungen der vollständigen Parallelität verwendet werden soll.Indicates that the value of the property should be used for optimistic concurrency checks. Alle primitiven TypeigenschaftenAll primitive type properties
Default Gibt den Standardwert der Eigenschaft an, wenn bei der Instanziierung kein Wert angegeben wird.Specifies the default value of the property if no value is supplied upon instantiation. Alle primitiven TypeigenschaftenAll primitive type properties
FixedLength Gibt an, ob sich die Länge des Eigenschaftswerts ändern kann.Specifies whether the length of the property value can vary. Binary, StringBinary, String
MaxLength Gibt die maximale Länge des Eigenschaftswerts an.Specifies the maximum length of the property value. Binary, StringBinary, String
Nullable Gibt an, ob die Eigenschaft über einen NULL-Wert verfügen kann.Specifies whether the property can have a null value. Alle primitiven TypeigenschaftenAll primitive type properties
Precision Bei Eigenschaften des Typs Decimal wird die Anzahl der Ziffern angegeben, über die ein Eigenschaftswert verfügen kann.For properties of type Decimal, specifies the number of digits a property value can have. Bei Eigenschaften der Typen Time, DateTime und DateTimeOffset wird die Anzahl der Dezimalstellen für die Sekunden des Eigenschaftswerts angegeben.For properties of type Time, DateTime, and DateTimeOffset, specifies the number of digits for the fractional part of seconds of the property value. DateTime, DateTimeOffset, Decimal, Time,DateTime, DateTimeOffset, Decimal, Time,
Scale Gibt die Anzahl der Dezimalstellen für den Eigenschaftswert an.Specifies the number of digits to the right of the decimal point for the property value. DecimalDecimal
Unicode Gibt an, ob der Eigenschaftswert als Unicode gespeichert wird.Indicates whether the property value is stored as Unicode. String

BeispielExample

Der ADO.NET-Entity Framework verwendet eine domänenspezifische Sprache (DSL) mit der Bezeichnung konzeptionelle Schema Definitions Sprache (CSDL), um konzeptionelle Modelle zu definieren.The ADO.NET Entity Framework uses a domain-specific language (DSL) called conceptual schema definition language (CSDL) to define conceptual models. Die folgende CSDL definiert einen Book-Entitätstyp.The following CSDL defines a Book entity type. Beachten Sie, dass Facets als XML-Attribute implementiert werden.Note that facets are implemented as XML attributes. Die Facetwerte geben an, dass keine Eigenschaft auf NULL festgelegt werden kann, und dass Scale und Precision der Revision-Eigenschaft jeweils auf 29 festgelegt werden.The facet values indicate that no property can be set to null, and that the Scale and Precision of the Revision property are each set to 29.

<EntityType Name="Book">
  <Key>
    <PropertyRef Name="ISBN" />
  </Key>
  <Property Type="String" Name="ISBN" Nullable="false" />
  <Property Type="String" Name="Title" Nullable="false" />
  <Property Type="Decimal" Name="Revision" Nullable="false" Precision="29" Scale="29" />
  <NavigationProperty Name="Publisher" Relationship="BooksModel.PublishedBy"
                      FromRole="Book" ToRole="Publisher" />
  <NavigationProperty Name="Authors" Relationship="BooksModel.WrittenBy"
                      FromRole="Book" ToRole="Author" />
</EntityType>

Siehe auchSee also