XmlSchemaUnique Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
unique Представляет элемент из схемы XML, указанной консорциумом W3C. Этот класс можно использовать для определения уникального ограничения между набором элементов.
public ref class XmlSchemaUnique : System::Xml::Schema::XmlSchemaIdentityConstraint
public class XmlSchemaUnique : System.Xml.Schema.XmlSchemaIdentityConstraint
type XmlSchemaUnique = class
inherit XmlSchemaIdentityConstraint
Public Class XmlSchemaUnique
Inherits XmlSchemaIdentityConstraint
- Наследование
Примеры
В следующем примере показано использование XmlSchemaUnique класса.
using System;
using System.Xml;
using System.Xml.Schema;
class XMLSchemaExamples
{
public static void Main()
{
XmlSchema schema = new XmlSchema();
// <xs:complexType name="customerOrderType">
XmlSchemaComplexType customerOrderType = new XmlSchemaComplexType();
customerOrderType.Name = "customerOrderType";
// <xs:sequence>
XmlSchemaSequence sequence1 = new XmlSchemaSequence();
// <xs:element name="item" minOccurs="0" maxOccurs="unbounded">
XmlSchemaElement item = new XmlSchemaElement();
item.MinOccurs = 0;
item.MaxOccursString = "unbounded";
item.Name = "item";
// <xs:complexType>
XmlSchemaComplexType ct1 = new XmlSchemaComplexType();
// <xs:attribute name="itemID" type="xs:string"/>
XmlSchemaAttribute itemID = new XmlSchemaAttribute();
itemID.Name = "itemID";
itemID.SchemaTypeName = new XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema");
// </xs:complexType>
ct1.Attributes.Add(itemID);
// </xs:element>
item.SchemaType = ct1;
// </xs:sequence>
sequence1.Items.Add(item);
customerOrderType.Particle = sequence1;
// <xs:attribute name="CustomerID" type="xs:string"/>
XmlSchemaAttribute CustomerID = new XmlSchemaAttribute();
CustomerID.Name = "CustomerID";
CustomerID.SchemaTypeName = new XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema");
customerOrderType.Attributes.Add(CustomerID);
// </xs:complexType>
schema.Items.Add(customerOrderType);
// <xs:element name="ordersByCustomer">
XmlSchemaElement ordersByCustomer = new XmlSchemaElement();
ordersByCustomer.Name = "ordersByCustomer";
// <xs:complexType>
XmlSchemaComplexType ct2 = new XmlSchemaComplexType();
// <xs:sequence>
XmlSchemaSequence sequence2 = new XmlSchemaSequence();
// <xs:element name="customerOrders" type="customerOrderType" minOccurs="0" maxOccurs="unbounded" />
XmlSchemaElement customerOrders = new XmlSchemaElement();
customerOrders.MinOccurs = 0;
customerOrders.MaxOccursString = "unbounded";
customerOrders.Name = "customerOrders";
customerOrders.SchemaTypeName = new XmlQualifiedName("customerOrderType", "");
// </xs:sequence>
sequence2.Items.Add(customerOrders);
// </xs:complexType>
ct2.Particle = sequence2;
ordersByCustomer.SchemaType = ct2;
// <xs:unique name="oneCustomerOrdersforEachCustomerID">
XmlSchemaUnique element_unique = new XmlSchemaUnique();
element_unique.Name = "oneCustomerOrdersforEachCustomerID";
// <xs:selector xpath="customerOrders"/>
element_unique.Selector = new XmlSchemaXPath();
element_unique.Selector.XPath = "customerOrders";
// <xs:field xpath="@customerID"/>
XmlSchemaXPath field = new XmlSchemaXPath();
field.XPath = "@customerID";
// </xs:unique>
element_unique.Fields.Add(field);
ordersByCustomer.Constraints.Add(element_unique);
// </xs:element>
schema.Items.Add(ordersByCustomer);
XmlSchemaSet schemaSet = new XmlSchemaSet();
schemaSet.ValidationEventHandler += new ValidationEventHandler(ValidationCallbackOne);
schemaSet.Add(schema);
schemaSet.Compile();
XmlSchema compiledSchema = null;
foreach (XmlSchema schema1 in schemaSet.Schemas())
{
compiledSchema = schema1;
}
XmlNamespaceManager nsmgr = new XmlNamespaceManager(new NameTable());
nsmgr.AddNamespace("xs", "http://www.w3.org/2001/XMLSchema");
compiledSchema.Write(Console.Out, nsmgr);
}
public static void ValidationCallbackOne(object sender, ValidationEventArgs args)
{
Console.WriteLine(args.Message);
}
}
Imports System.Xml
Imports System.Xml.Schema
Class XMLSchemaExamples
Public Shared Sub Main()
Dim schema As New XmlSchema()
' <xs:complexType name="customerOrderType">
Dim customerOrderType As New XmlSchemaComplexType()
customerOrderType.Name = "customerOrderType"
' <xs:sequence>
Dim sequence1 As New XmlSchemaSequence()
' <xs:element name="item" minOccurs="0" maxOccurs="unbounded">
Dim item As New XmlSchemaElement()
item.MinOccurs = 0
item.MaxOccursString = "unbounded"
item.Name = "item"
' <xs:complexType>
Dim ct1 As New XmlSchemaComplexType()
' <xs:attribute name="itemID" type="xs:string"/>
Dim itemID As New XmlSchemaAttribute()
itemID.Name = "itemID"
itemID.SchemaTypeName = New XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema")
' </xs:complexType>
ct1.Attributes.Add(itemID)
' </xs:element>
item.SchemaType = ct1
' </xs:sequence>
sequence1.Items.Add(item)
customerOrderType.Particle = sequence1
' <xs:attribute name="CustomerID" type="xs:string"/>
Dim CustomerID As New XmlSchemaAttribute()
CustomerID.Name = "CustomerID"
CustomerID.SchemaTypeName = New XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema")
customerOrderType.Attributes.Add(CustomerID)
' </xs:complexType>
schema.Items.Add(customerOrderType)
' <xs:element name="ordersByCustomer">
Dim ordersByCustomer As New XmlSchemaElement()
ordersByCustomer.Name = "ordersByCustomer"
' <xs:complexType>
Dim ct2 As New XmlSchemaComplexType()
' <xs:sequence>
Dim sequence2 As New XmlSchemaSequence()
' <xs:element name="customerOrders" type="customerOrderType" minOccurs="0" maxOccurs="unbounded" />
Dim customerOrders As New XmlSchemaElement()
customerOrders.MinOccurs = 0
customerOrders.MaxOccursString = "unbounded"
customerOrders.Name = "customerOrders"
customerOrders.SchemaTypeName = New XmlQualifiedName("customerOrderType", "")
' </xs:sequence>
sequence2.Items.Add(customerOrders)
' </xs:complexType>
ct2.Particle = sequence2
ordersByCustomer.SchemaType = ct2
' <xs:unique name="oneCustomerOrdersforEachCustomerID">
Dim element_unique As New XmlSchemaUnique()
element_unique.Name = "oneCustomerOrdersforEachCustomerID"
' <xs:selector xpath="customerOrders"/>
element_unique.Selector = New XmlSchemaXPath()
element_unique.Selector.XPath = "customerOrders"
' <xs:field xpath="@customerID"/>
Dim field As New XmlSchemaXPath()
field.XPath = "@customerID"
' </xs:unique>
element_unique.Fields.Add(field)
ordersByCustomer.Constraints.Add(element_unique)
' </xs:element>
schema.Items.Add(ordersByCustomer)
Dim schemaSet As New XmlSchemaSet()
AddHandler schemaSet.ValidationEventHandler, AddressOf ValidationCallbackOne
schemaSet.Add(schema)
schemaSet.Compile()
Dim compiledSchema As XmlSchema = Nothing
For Each schema1 As XmlSchema In schemaSet.Schemas()
compiledSchema = schema1
Next
Dim nsmgr As New XmlNamespaceManager(New NameTable())
nsmgr.AddNamespace("xs", "http://www.w3.org/2001/XMLSchema")
compiledSchema.Write(Console.Out, nsmgr)
End Sub
Public Shared Sub ValidationCallbackOne(ByVal sender As Object, ByVal args As ValidationEventArgs)
Console.WriteLine(args.Message)
End Sub
End Class
Следующий XML-файл создается для этого примера кода.
<?xml version="1.0" encoding="IBM437"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexType name="customerOrderType">
<xs:sequence>
<xs:element name="item" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="itemID" type="xs:string"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="CustomerID" type="xs:string"/>
</xs:complexType>
<xs:element name="ordersByCustomer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerOrders" type="customerOrderType" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
<xs:unique name="oneCustomerOrdersforEachCustomerID">
<xs:selector xpath="customerOrders"/>
<xs:field xpath="@customerID"/>
</xs:unique>
</xs:element>
</xs:schema>
Комментарии
Указывает, что атрибут или значение элемента (или сочетание значений атрибута или элемента) должно быть уникальным в пределах указанной области. Имя ограничения должно быть уникальным в схеме.
Конструкторы
| Имя | Описание |
|---|---|
| XmlSchemaUnique() |
Инициализирует новый экземпляр класса XmlSchemaUnique. |
Свойства
| Имя | Описание |
|---|---|
| Annotation |
Возвращает или задает |
| Fields |
Возвращает коллекцию полей, которые применяются в качестве дочерних элементов для селектора выражений языка XML (XPath). (Унаследовано от XmlSchemaIdentityConstraint) |
| Id |
Возвращает или задает идентификатор строки. (Унаследовано от XmlSchemaAnnotated) |
| LineNumber |
Возвращает или задает номер строки в файле, к которому |
| LinePosition |
Получает или задает позицию строки в файле, к которому |
| Name |
Возвращает или задает имя ограничения удостоверения. (Унаследовано от XmlSchemaIdentityConstraint) |
| Namespaces |
Возвращает или задает XmlSerializerNamespaces для использования с этим объектом схемы. (Унаследовано от XmlSchemaObject) |
| Parent |
Возвращает или задает родительский элемент этого XmlSchemaObjectэлемента. (Унаследовано от XmlSchemaObject) |
| QualifiedName |
Возвращает полное имя ограничения удостоверения, которое содержит значение свойства после компиляции |
| Selector |
Возвращает или задает элемент выражения |
| SourceUri |
Возвращает или задает исходное расположение файла, загруженного схемой. (Унаследовано от XmlSchemaObject) |
| UnhandledAttributes |
Возвращает или задает квалифицированные атрибуты, которые не принадлежат целевому пространству имен текущей схемы. (Унаследовано от XmlSchemaAnnotated) |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |