Mapper les contraintes clés de schéma XML (XSD) aux contraintes de DataSet
Dans un schéma, vous pouvez spécifier une contrainte de clé sur un élément ou un attribut à l’aide de l’élément key. L'élément ou attribut sur lequel une contrainte de clé est spécifiée doit avoir des valeurs uniques dans toute instance du schéma et ne peut pas avoir de valeurs null.
La contrainte de clé est similaire à la contrainte unique, si ce n'est que la colonne sur laquelle une contrainte de clé est définie ne peut pas comporter de valeurs null.
Le tableau suivant présente les attributs msdata que vous pouvez spécifier dans l’élément key.
| Nom de l’attribut | Description |
|---|---|
| msdata:ConstraintName | Si cet attribut est spécifié, sa valeur est utilisée comme nom de la contrainte. Sinon, l’attribut name fournit la valeur du nom de la contrainte. |
| msdata:PrimaryKey | Si PrimaryKey="true" est inclus, la propriété de contrainte IsPrimaryKey a la valeur true, ce qui en fait une clé primaire. La propriété de colonne AllowDBNull a la valeur false parce que les clés primaires ne peuvent pas contenir de valeurs null. |
En convertissant un schéma dans lequel une contrainte de clé est spécifiée, le processus de mappage crée une contrainte unique sur la table avec la propriété de colonne AllowDBNull définie sur false pour chaque colonne mentionnée dans la contrainte. La propriété IsPrimaryKey de la contrainte unique a également la valeur false, sauf si vous avez spécifié msdata:PrimaryKey="true" sur l’élément key. Ce mode de fonctionnement est identique à celui d'une contrainte unique dans le schéma faisant apparaître PrimaryKey="true".
Dans l’exemple de schéma suivant, l’élément key spécifie la contrainte de clé sur l’élément CustomerID.
<xs:schema id="cod"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
<xs:element name="Customers">
<xs:complexType>
<xs:sequence>
<xs:element name="CustomerID" type="xs:string" minOccurs="0" />
<xs:element name="CompanyName" type="xs:string" minOccurs="0" />
<xs:element name="Phone" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="MyDataSet" msdata:IsDataSet="true">
<xs:complexType>
<xs:choice maxOccurs="unbounded">
<xs:element ref="Customers" />
</xs:choice>
</xs:complexType>
<xs:key msdata:PrimaryKey="true"
msdata:ConstraintName="KeyCustID"
name="KeyConstCustomerID" >
<xs:selector xpath=".//Customers" />
<xs:field xpath="CustomerID" />
</xs:key>
</xs:element>
</xs:schema>
L’élément key spécifie que les valeurs de l’élément enfant CustomerID de l’élément Customers doivent avoir des valeurs uniques et pas de valeurs null. En convertissant le schéma en langage XSD (XML Schema Definition), le processus de mappage crée la table suivante :
Customers(CustomerID, CompanyName, Phone)
Le mappage du schéma XML crée aussi une contrainte UniqueConstraint sur la colonne CustomerID, comme le montre le DataSet suivant. (Par souci de simplicité, seules les propriétés pertinentes sont représentées.)
DataSetName: MyDataSet
TableName: customers
ColumnName: CustomerID
AllowDBNull: False
Unique: True
ConstraintName: KeyCustID
Table: customers
Columns: CustomerID
IsPrimaryKey: True
Dans le DataSet généré, la propriété IsPrimaryKey de UniqueConstraint a la valeur true parce que le schéma spécifie msdata:PrimaryKey="true" dans l’élément key.
La valeur de la propriété ConstraintName de la contrainte UniqueConstraint du DataSet correspond à la valeur de l’attribut msdata:ConstraintName spécifié dans l’élément key du schéma.