Condividi tramite

Vincoli e relazioni di XML Schema (ADO.NET)

  • Articolo

Nello schema XSD (XML Schema Definition Language) è possibile specificare vincoli (univoci, key e keyref) e relazioni (mediante l'annotazione msdata:Relationship). In questo argomento viene spiegato come vengono interpretati i vincoli e le relazioni specificati in XML Schema per generare il tipo DataSet.

In genere, in XML Schema l'annotazione msdata:Relationship viene specificata solo se si desidera generare relazioni nell'oggetto DataSet. Per ulteriori informazioni, vedere Generazione delle relazioni del DataSet da XML Schema (XSD). I vincoli (univoci, key e keyref) vengono specificati se si desidera generare vincoli nel DataSet. Notare che i vincoli key e keyref vengono utilizzati anche per generare relazioni, come spiegato successivamente in questo argomento.

Generazione di una relazione dai vincoli key e keyref

Anziché specificare l'annotazione msdata:Relationship, è possibile specificare i vincoli key e keyref, utilizzati durante il processo di mapping di XML Schema per la generazione non solo dei vincoli ma anche delle relazioni nel DataSet. Se tuttavia si specifica msdata:ConstraintOnly="true" nell'elemento keyref, nel DataSet saranno inclusi solo i vincoli e non verrà inclusa la relazione.

Nell'esempio seguente viene illustrato un XML Schema in cui sono inclusi gli elementi non annidati Order e OrderDetail. Nello schema vengono specificati anche i vincoli key e keyref.

<xs:schema id="MyDataSet"  
            xmlns:xs="http://www.w3.org/2001/XMLSchema" 
            xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">

 <xs:element name="MyDataSet" msdata:IsDataSet="true">
  <xs:complexType>
    <xs:choice maxOccurs="unbounded">
      <xs:element name="OrderDetail">
       <xs:complexType>
         <xs:sequence>
           <xs:element name="OrderNo" type="xs:integer" />
           <xs:element name="ItemNo" type="xs:string" />
         </xs:sequence>
       </xs:complexType>
      </xs:element>
      <xs:element name="Order">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="OrderNumber" type="xs:integer" />
            <xs:element name="EmpNumber" type="xs:integer" />
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:choice>
  </xs:complexType>

  <xs:key name="OrderNumberKey"  >
    <xs:selector xpath=".//Order" />
    <xs:field xpath="OrderNumber" />
  </xs:key>

  <xs:keyref name="OrderNoRef" refer="OrderNumberKey">
    <xs:selector xpath=".//OrderDetail" />
    <xs:field xpath="OrderNo" />
  </xs:keyref>
 </xs:element>
</xs:schema>

Nel DataSet generato durante il processo di mapping di XML Schema sono incluse le tabelle Order e OrderDetail. Nel DataSet sono inoltre inclusi i vincoli e le relazioni. Nell'esempio seguente vengono illustrati tali vincoli e relazioni. Notare che nello schema non viene specificata l'annotazione msdata:Relationship. Per generare la relazione vengono infatti utilizzati i vincoli key e keyref.

....ConstraintName: OrderNumberKey
....Type: UniqueConstraint
....Table: Order
....Columns: OrderNumber
....IsPrimaryKey: False

....ConstraintName: OrderNoRef
....Type: ForeignKeyConstraint
....Table: OrderDetail
....Columns: OrderNo
....RelatedTable: Order
....RelatedColumns: OrderNumber

..RelationName: OrderNoRef
..ParentTable: Order
..ParentColumns: OrderNumber
..ChildTable: OrderDetail
..ChildColumns: OrderNo
..ParentKeyConstraint: OrderNumberKey
..ChildKeyConstraint: OrderNoRef
..Nested: False

Gli elementi Order e OrderDetail del precedente esempio di schema non sono annidati. Nell'esempio di schema seguente tali elementi sono annidati. Tuttavia, non viene specificata alcuna annotazione msdata:Relationship, quindi si presuppone una relazione implicita. Per ulteriori informazioni, vedere Mappare relazioni implicite tra elementi annidati dello schema (ADO.NET). Nello schema vengono specificati anche i vincoli key e keyref.

<xs:schema id="MyDataSet"  
            xmlns:xs="http://www.w3.org/2001/XMLSchema" 
            xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">

 <xs:element name="MyDataSet" msdata:IsDataSet="true">
  <xs:complexType>
    <xs:choice maxOccurs="unbounded">

      <xs:element name="Order">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="OrderNumber" type="xs:integer" />
            <xs:element name="EmpNumber" type="xs:integer" />

            <xs:element name="OrderDetail">
              <xs:complexType>
                <xs:sequence>
                  <xs:element name="OrderNo" type="xs:integer" />
                  <xs:element name="ItemNo" type="xs:string" />
                </xs:sequence>
              </xs:complexType>
            </xs:element>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:choice>
  </xs:complexType>

  <xs:key name="OrderNumberKey"  >
    <xs:selector xpath=".//Order" />
    <xs:field xpath="OrderNumber" />
  </xs:key>

  <xs:keyref name="OrderNoRef" refer="OrderNumberKey">
    <xs:selector xpath=".//OrderDetail" />
    <xs:field xpath="OrderNo" />
  </xs:keyref>
 </xs:element>
</xs:schema>

Nel DataSet risultante dal processo di mapping di XML Schema sono incluse due tabelle:

Order(OrderNumber, EmpNumber, Order_Id)
OrderDetail(OrderNumber, ItemNumber, Order_Id)

Nel DataSet sono inoltre incluse le due relazioni (una basata sull'annotazione msdata:relationship e l'altra basata sui vincoli key e keyref) e diversi vincoli. Nell'esempio seguente vengono illustrati i vincoli e le relazioni.

..RelationName: Order_OrderDetail
..ParentTable: Order
..ParentColumns: Order_Id
..ChildTable: OrderDetail
..ChildColumns: Order_Id
..ParentKeyConstraint: Constraint1
..ChildKeyConstraint: Order_OrderDetail
..Nested: True

..RelationName: OrderNoRef
..ParentTable: Order
..ParentColumns: OrderNumber
..ChildTable: OrderDetail
..ChildColumns: OrderNo
..ParentKeyConstraint: OrderNumberKey
..ChildKeyConstraint: OrderNoRef
..Nested: False

..ConstraintName: OrderNumberKey
..Type: UniqueConstraint
..Table: Order
..Columns: OrderNumber
..IsPrimaryKey: False

..ConstraintName: Constraint1
..Type: UniqueConstraint
..Table: Order
..Columns: Order_Id
..IsPrimaryKey: True

..ConstraintName: Order_OrderDetail
..Type: ForeignKeyConstraint
..Table: OrderDetail
..Columns: Order_Id
..RelatedTable: Order
..RelatedColumns: Order_Id

..ConstraintName: OrderNoRef
..Type: ForeignKeyConstraint
..Table: OrderDetail
..Columns: OrderNo
..RelatedTable: Order
..RelatedColumns: OrderNumber

Se in un vincolo keyref che fa riferimento a una tabella annidata è contenuta un'annotazione msdata:IsNested="true", nel DataSet verrà creata un'unica relazione annidata basata sul vincolo keyref e sul vincolo univoco/key correlato.

Vedere anche

Altre risorse

Derivazione della struttura relazionale di un DataSet da XML Schema (XSD)