Proprietà estesa (CSDL)

In Entity Data Model (EDM) una proprietà estesa è una proprietà definita ed esistente nello spazio dei nomi di un utente anziché nello spazio dei nomi di sistema identificato da xmlns="https://schemas.microsoft.com/ado/2006/04/edm". Per definire entrambi i tipi di proprietà viene utilizzato CSDL (Conceptual Schema Definition Language). Per aggiungere una proprietà estesa a uno schema CSDL, definire uno spazio dei nomi, quindi utilizzarlo nella definizione di un tipo di entità e del set di entità corrispondente.

Nell'esempio seguente viene definito uno spazio dei nomi xmlns:o1="http://other.contoso.com/schema". Il prefisso dello spazio dei nomi o1 serve come alias nelle definizioni del tipo di entità AWBuildVersion e del set di entità 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 è un'enumerazione presente negli oggetti MetadataProperty che è possibile utilizzare per identificare le proprietà di sistema e le proprietà estese in EDM. Per un esempio di utilizzo di questa enumerazione nel codice, vedere Utilizzo del modello a oggetti di AdventureWorks (EDM).

Esecuzione di codice in cui sono utilizzate proprietà estese

Le modifiche allo schema con le proprietà estese possono essere verificate tramite il modello di dati e il codice dell'applicazione in Modello completo di AdventureWorks (EDM). Aggiungere le modifiche allo schema csdl e ricompilare il modello a oggetti con Edmgen.exe come descritto nell'argomento relativo ad AdventureWorks.

Aggiungere quindi il codice seguente all'applicazione client dell'argomento Utilizzo del modello a oggetti di AdventureWorks (EDM). Questi metodi devono essere aggiunti alla classe Program e chiamati dal codice nel commento che fa riferimento alla funzione DisplayProperties.

        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));
            }
        }

Vedere anche

Concetti

Schema concettuale completo di AdventureWorks (EDM)
Schema di archiviazione completo di AdventureWorks (EDM)
Schema di mapping completo di AdventureWorks (EDM)
Utilizzo del modello a oggetti di AdventureWorks (EDM)