Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
XmlSchemaMaxLengthFacet Class
Collapse the table of content
Expand the table of content

XmlSchemaMaxLengthFacet Class

Specifies a restriction on the maximum length of a simpleType element, based on the datatype. Represents the World Wide Web Consortium (W3C) maxLength facet.

For a list of all members of this type, see XmlSchemaMaxLengthFacet Members.


[Visual Basic]
Public Class XmlSchemaMaxLengthFacet
   Inherits XmlSchemaNumericFacet
public class XmlSchemaMaxLengthFacet : XmlSchemaNumericFacet
public __gc class XmlSchemaMaxLengthFacet : public
public class XmlSchemaMaxLengthFacet extends XmlSchemaNumericFacet

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.


[Visual Basic, C#, C++] The following example shows the use of the XmlSchemaMaxLengthFacet class.

[Visual Basic] 
Imports System
Imports System.Xml  
Imports System.Xml.Schema

Class XMLSchemaExamples 
    Public Shared Sub Main()

    Dim schema as New XmlSchema()

    ' <xs:simpleType name="ZipCodeType">
    Dim ZipCodeType as New XmlSchemaSimpleType()
    ZipCodeType.Name = "ZipCodeType"

    ' <xs:restriction base="xs:string">
    Dim restriction as New XmlSchemaSimpleTypeRestriction()
    restriction.BaseTypeName = new XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema")

    ' <xs:maxLength value="10"/>
    Dim maxLength as New XmlSchemaMaxLengthFacet()
    maxLength.Value = "10"

    ZipCodeType.Content = restriction


    ' <xs:element name="Address">
    Dim element as New XmlSchemaElement()
    element.Name = "Address"

    ' <xs:complexType>
    Dim complexType as New XmlSchemaComplexType()

    ' <xs:attribute name="ZipCode" type="ZipCodeType"/>
    Dim ZipCodeAttribute as New XmlSchemaAttribute()
    ZipCodeAttribute.Name = "ZipCode"
    ZipCodeAttribute.SchemaTypeName = new XmlQualifiedName("ZipCodeType", "")

    element.SchemaType = complexType


    schema.Compile(AddressOf ValidationCallbackOne)
    Dim nsmgr As New XmlNamespaceManager(New NameTable())
    nsmgr.AddNamespace("xs", "http://www.w3.org/2001/XMLSchema")
    schema.Write(Console.Out, nsmgr)

End Sub

  Public Shared Sub ValidationCallbackOne(sender as object, args as ValidationEventArgs) 
  End Sub

End Class

using System;
using System.Xml;  
using System.Xml.Schema;

class XMLSchemaExamples {
    public static void Main() {
        XmlSchema schema = new XmlSchema();

        // <xs:simpleType name="ZipCodeType">
        XmlSchemaSimpleType ZipCodeType = new XmlSchemaSimpleType();
        ZipCodeType.Name = "ZipCodeType";

        // <xs:restriction base="xs:string">
        XmlSchemaSimpleTypeRestriction restriction = new XmlSchemaSimpleTypeRestriction();
        restriction.BaseTypeName = new XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema");

        // <xs:maxLength value="10"/>
        XmlSchemaMaxLengthFacet maxLength = new XmlSchemaMaxLengthFacet();
        maxLength.Value = "10";

        ZipCodeType.Content = restriction;


        // <xs:element name="Address">
        XmlSchemaElement element = new XmlSchemaElement();
        element.Name = "Address";

        // <xs:complexType>
        XmlSchemaComplexType complexType = new XmlSchemaComplexType();

        // <xs:attribute name="ZipCode" type="ZipCodeType"/>
        XmlSchemaAttribute ZipCodeAttribute = new XmlSchemaAttribute();
        ZipCodeAttribute.Name = "ZipCode";
        ZipCodeAttribute.SchemaTypeName = new XmlQualifiedName("ZipCodeType", "");

        element.SchemaType = complexType;


        schema.Compile(new ValidationEventHandler(ValidationCallbackOne));
     XmlNamespaceManager nsmgr = new XmlNamespaceManager(new NameTable());
        nsmgr.AddNamespace("xs", "http://www.w3.org/2001/XMLSchema");
        schema.Write(Console.Out, nsmgr);

    public static void ValidationCallbackOne(object sender, ValidationEventArgs args) {

#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::Xml;  
using namespace System::Xml::Schema;

__gc class XMLSchemaExamples
   static void ValidationCallbackOne(Object* sender, ValidationEventArgs * args)
      Console::WriteLine(args -> Message);

int main() 
   XmlSchema* schema = new XmlSchema();

   // <xs:simpleType name=S"ZipCodeType">
   XmlSchemaSimpleType* ZipCodeType = new XmlSchemaSimpleType();
   ZipCodeType -> Name = S"ZipCodeType";

   // <xs:restriction base="xs:string">
   XmlSchemaSimpleTypeRestriction* restriction = new XmlSchemaSimpleTypeRestriction();
   restriction -> BaseTypeName = new XmlQualifiedName(S"string", S"http://www.w3.org/2001/XMLSchema");

   // <xs:maxLength value=S"10"/>
   XmlSchemaMaxLengthFacet* maxLength = new XmlSchemaMaxLengthFacet();
   maxLength -> Value = S"10";
   restriction -> Facets->Add(maxLength);

   ZipCodeType -> Content = restriction;

   schema -> Items->Add(ZipCodeType);

   // <xs:element name=S"Address">
   XmlSchemaElement* element = new XmlSchemaElement();
   element -> Name = S"Address";

   // <xs:complexType>
   XmlSchemaComplexType* complexType = new XmlSchemaComplexType();

   // <xs:attribute name=S"ZipCode" type=S"ZipCodeType"/>
   XmlSchemaAttribute* ZipCodeAttribute = new XmlSchemaAttribute();
   ZipCodeAttribute -> Name = S"ZipCode";
   ZipCodeAttribute -> SchemaTypeName = new XmlQualifiedName(S"ZipCodeType", S"");

   complexType -> Attributes->Add(ZipCodeAttribute);

   element -> SchemaType = complexType;

   schema -> Items->Add(element);

   schema -> Compile(new ValidationEventHandler(schema, XMLSchemaExamples::ValidationCallbackOne));
   XmlNamespaceManager* nsmgr = new XmlNamespaceManager(new NameTable());
   nsmgr -> AddNamespace(S"xs", S"http://www.w3.org/2001/XMLSchema");
   schema -> Write(Console::Out, nsmgr);

[Visual Basic, C#, C++] The following XML file is generated for the preceding code example.

<?xml version="1.0" encoding="IBM437"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

    <xs:simpleType name="ZipCodeType">
        <xs:restriction base="xs:string">
            <xs:maxLength value="10"/>

    <xs:element name="Address">
            <xs:attribute name="ZipCode" type="ZipCodeType"/>


[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.


Namespace: System.Xml.Schema

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: System.Xml (in System.Xml.dll)

See Also

XmlSchemaMaxLengthFacet Members | System.Xml.Schema Namespace

© 2015 Microsoft