Vincoli e relazioni di XML Schema

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 vogliono generare relazioni nell'oggetto DataSet. Per altre informazioni, vedere Generazione di relazioni tra dataset da XML Schema (XSD). I vincoli (univoci, key e keyref) vengono specificati se si vogliono generare vincoli nel DataSet. Notare che i vincoli key e keyref vengono usati anche per generare relazioni, come spiegato successivamente in questo argomento.

Generazione di una relazione dai vincoli key e keyref

Invece di specificare l'annotazione msdata:Relationship, è possibile specificare i vincoli key e keyref, usati 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=""
            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 usati 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 altre informazioni, vedere Mapping di relazioni implicite tra elementi di schemi annidati. Nello schema vengono specificati anche i vincoli key e keyref.

<xs:schema id="MyDataSet" xmlns=""
            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.

Vedi anche