XmlSchemaUnique Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa el unique elemento del esquema XML tal y como especifica World Wide Web Consortium (W3C). Esta clase se puede usar para identificar una restricción única entre un conjunto de elementos.
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
- Herencia
Ejemplos
En el ejemplo siguiente se muestra el uso de la XmlSchemaUnique clase .
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
El siguiente archivo XML se genera para este ejemplo de código.
<?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>
Comentarios
Especifica que un atributo o valor de elemento (o una combinación de valores de atributo o elemento) debe ser único dentro del ámbito especificado. El nombre de la restricción debe ser único dentro de un esquema.
Constructores
| Nombre | Description |
|---|---|
| XmlSchemaUnique() |
Inicializa una nueva instancia de la clase XmlSchemaUnique. |
Propiedades
| Nombre | Description |
|---|---|
| Annotation |
Obtiene o establece la |
| Fields |
Obtiene la colección de campos que se aplican como elementos secundarios para el selector de expresiones del lenguaje de ruta de acceso XML (XPath). (Heredado de XmlSchemaIdentityConstraint) |
| Id |
Obtiene o establece el identificador de cadena. (Heredado de XmlSchemaAnnotated) |
| LineNumber |
Obtiene o establece el número de línea del archivo al que hace referencia el |
| LinePosition |
Obtiene o establece la posición de línea del archivo al que hace referencia el |
| Name |
Obtiene o establece el nombre de la restricción de identidad. (Heredado de XmlSchemaIdentityConstraint) |
| Namespaces |
Obtiene o establece el objeto XmlSerializerNamespaces que se va a usar con este objeto de esquema. (Heredado de XmlSchemaObject) |
| Parent |
Obtiene o establece el elemento primario de este XmlSchemaObjectobjeto . (Heredado de XmlSchemaObject) |
| QualifiedName |
Obtiene el nombre completo de la restricción de identidad, que contiene el valor posterior a la compilación de la |
| Selector |
Obtiene o establece el elemento de expresión |
| SourceUri |
Obtiene o establece la ubicación de origen del archivo que cargó el esquema. (Heredado de XmlSchemaObject) |
| UnhandledAttributes |
Obtiene o establece los atributos calificados que no pertenecen al espacio de nombres de destino del esquema actual. (Heredado de XmlSchemaAnnotated) |
Métodos
| Nombre | Description |
|---|---|
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| GetHashCode() |
Actúa como función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |