Erweiterte Eigenschaft (CSDL)

Im Entity Data Model (EDM) ist eine erweiterte Eigenschaft eine Eigenschaft, die statt im Systemnamespace (angegeben durch xmlns="https://schemas.microsoft.com/ado/2006/04/edm") im Namespace eines Benutzers definiert und vorhanden ist. Beide Arten von Eigenschaften werden mit der konzeptionellen Schemadefinitionssprache (CSDL) definiert. Um einem CSDL-Schema eine erweiterte Eigenschaft hinzuzufügen, definieren Sie einen Namespace und verwenden ihn in der Definition eines Entitätstyps und der entsprechenden Entitätenmenge.

Im folgenden Beispiel wird der Namespace xmlns:o1="http://other.contoso.com/schema" definiert. Das Namespacepräfix o1 dient als Alias in den Definitionen des Entitätstyps AWBuildVersion und der Entitätenmenge AWBuildVersions.

<?xml version="1.0" encoding="utf-8"?>
<Schema Namespace="AdventureWorksModel" Alias="Self" 
        xmlns="https://schemas.microsoft.com/ado/2006/04/edm"
        xmlns:o1="http://other.contoso.com/schema">

  <EntityContainer Name="AdventureWorksEntities"
          o1:MyCustomAttribute="MyCustomAttributeValue">

    <EntitySet Name="AWBuildVersions"
          EntityType="Adventureworks.AWBuildVersion"
          o1:AnotherAttribute="AnotherAttributeValue"/>

  </EntityContainer>

…...

<EntityType Name="AWBuildVersion">
          <Key>
            <PropertyRef Name="SystemInformationID" />
          </Key>
          <Property Name="SystemInformationID"
                      Type="Byte" Nullable="false" />
          <Property Name="Database_Version" Type="String"
                      Nullable="false" />
          <Property Name="VersionDate" 
                      Type="DateTime" Nullable="false" />
          <Property Name="ModifiedDate"
                      Type="DateTime" Nullable="false" />
        </EntityType>

PropertyKind ist eine Enumeration, die zu MetadataProperty-Objekten gehört und verwendet werden kann, um Systemeigenschaften und erweiterte Eigenschaften im EDM anzugeben. Ein Beispiel zur Verwendung dieser Enumeration in Code finden Sie unter Verwendung des AdventureWorks-Objektmodells (EDM).

Ausführen von Code, in dem erweiterte Eigenschaften verwendet werden

Die Schemaänderungen mit den erweiterten Eigenschaften können mithilfe des Datenmodells und Anwendungscodes in Das vollständige AdventureWorks-Modell (EDM) getestet werden. Fügen Sie dem CSDL-Schema die Änderungen hinzu, und erstellen Sie das Objektmodell mit Edmgen.exe erneut. Folgen Sie dabei den Beschreibungen im AdventureWorks-Thema.

Fügen Sie dann der Clientanwendung im Thema Verwendung des AdventureWorks-Objektmodells (EDM) folgenden Code hinzu. Diese Methoden sollten der Program-Klasse hinzugefügt und vom Code in dem Kommentar aufgerufen werden, der auf die DisplayProperties-Funktion verweist.

        public static void DisplayProperties(
        MetadataWorkspace workspace, DataSpace model)
        {
            // Get a collection of the entity containers.
            ReadOnlyCollection<EntityContainer> containers =
                workspace.GetItems<EntityContainer>(model);

            // Iterate through collection to get each entity container.
            foreach (EntityContainer container in containers)
            {
                // Display extended properties for the entity container.
                DisplayExtendedProperties(container);

                // Iterate through collection to get each entity set.
                foreach (EntitySetBase baseSet in container.BaseEntitySets)
                {
                    // Check if this instance is an EntitySet.
                    if (baseSet is EntitySet)
                    {
                        // Display extended properties for the entity set.
                        DisplayExtendedProperties(baseSet);
                    }
                }
            }

            // Get a collection of the entity types.
            ReadOnlyCollection<EntityType> entities =
                   workspace.GetItems<EntityType>(model);

            // Iterate through the collection to get each entity type.
            foreach (EntityType entity in entities)
            {
                // Display the extended properties for the entity type.
                DisplayExtendedProperties(entity);
            }
        }
        private static void DisplayExtendedProperties(MetadataItem item)
        {
            foreach (MetadataProperty property in item.MetadataProperties)
            {
                if (property.PropertyKind == PropertyKind.Extended)
                    Console.WriteLine(string.Format("\t{0}\t{1}\t{2}",
                      item.GetType().Name, property.Name, property.Value));
            }
        }

Siehe auch

Konzepte

Vollständiges konzeptionelles Schema für AdventureWorks (EDM)
Vollständiges Speicherschema für AdventureWorks (EDM)
Vollständiges Mappingschema für AdventureWorks (EDM)
Verwendung des AdventureWorks-Objektmodells (EDM)