Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

XmlSchemaException Class

Definition

Namespace:
System.Xml.Schema
Assemblies:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Source:
XmlSchemaException.cs
Source:
XmlSchemaException.cs
Source:
XmlSchemaException.cs
Source:
XmlSchemaException.cs
Source:
XmlSchemaException.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Returns detailed information about the schema exception.

public ref class XmlSchemaException : SystemException
public class XmlSchemaException : SystemException
[System.Serializable]
public class XmlSchemaException : SystemException
type XmlSchemaException = class
 inherit SystemException
[<System.Serializable>]
type XmlSchemaException = class
 inherit SystemException
Public Class XmlSchemaException
Inherits SystemException
Inheritance
XmlSchemaException
Derived
Attributes

Examples

The following example shows the use of the XmlSchemaException class.

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

public class ValidXSD
{
 public static int Main()
 {

 FileStream fs;
 XmlSchema schema;
 try
 {
 fs = new FileStream("example.xsd", FileMode.Open);
 schema = XmlSchema.Read(fs, new ValidationEventHandler(ShowCompileError));

 XmlSchemaSet schemaSet = new XmlSchemaSet();
 schemaSet.ValidationEventHandler += new ValidationEventHandler(ShowCompileError);
 schemaSet.Add(schema);
 schemaSet.Compile();

 XmlSchema compiledSchema = null;

 foreach (XmlSchema schema1 in schemaSet.Schemas())
 {
 compiledSchema = schema1;
 }

 schema = compiledSchema;

 if (schema.IsCompiled)
 {
 // Schema is successfully compiled.
 // Do something with it here.
 }
 return 0;
 }
 catch (XmlSchemaException e)
 {
 Console.WriteLine("LineNumber = {0}", e.LineNumber);
 Console.WriteLine("LinePosition = {0}", e.LinePosition);
 Console.WriteLine("Message = {0}", e.Message);
 return -1;
 }
 }

 private static void ShowCompileError(object sender, ValidationEventArgs e)
 {
 Console.WriteLine("Validation Error: {0}", e.Message);
 }
}
Option Strict On
Option Explicit On

Imports System.Xml
Imports System.Xml.Schema
Imports System.IO

Public Class ValidXSD
 Public Shared Sub Main()
 Dim fs As FileStream
 Dim schema As XmlSchema
 Try
 fs = New FileStream("example.xsd", FileMode.Open)
 schema = XmlSchema.Read(fs, New ValidationEventHandler(AddressOf ShowCompileError))

 Dim schemaSet As New XmlSchemaSet()
 AddHandler schemaSet.ValidationEventHandler, AddressOf ShowCompileError

 schemaSet.Add(schema)
 schemaSet.Compile()

 Dim compiledSchema As XmlSchema = Nothing

 For Each schema1 As XmlSchema In schemaSet.Schemas()
 compiledSchema = schema1
 Next

 schema = compiledSchema

 If schema.IsCompiled Then
 ' Schema is successfully compiled. 
 ' Do something with it here.
 End If

 Catch e As XmlSchemaException
 Console.WriteLine("LineNumber = {0}", e.LineNumber)
 Console.WriteLine("LinePosition = {0}", e.LinePosition)
 Console.WriteLine("Message = {0}", e.Message)
 Console.WriteLine("Source = {0}", e.Source)

 End Try
 End Sub


 Private Shared Sub ShowCompileError(ByVal sender As Object, ByVal e As ValidationEventArgs)
 Console.WriteLine("Validation Error: {0}", e.Message)
 End Sub
End Class

Remarks

Important

The XmlSchemaException class may contain sensitive information that should not be exposed in untrusted scenarios. For example, the SourceUri property returns the URI path to the schema file that caused the exception. The SourceUri property should not be exposed in untrusted scenarios. Exceptions should be properly handled so that this sensitive information is not exposed in untrusted scenarios.

Constructors

Name Description
XmlSchemaException()

Initializes a new instance of the XmlSchemaException class.

XmlSchemaException(SerializationInfo, StreamingContext)
Obsolete.

Constructs a new XmlSchemaException object with the given SerializationInfo and StreamingContext information that contains all the properties of the XmlSchemaException.

XmlSchemaException(String, Exception, Int32, Int32)

Initializes a new instance of the XmlSchemaException class with the exception message specified, and the original Exception object, line number, and line position of the XML that cause this exception specified.

XmlSchemaException(String, Exception)

Initializes a new instance of the XmlSchemaException class with the exception message and original Exception object that caused this exception specified.

XmlSchemaException(String)

Initializes a new instance of the XmlSchemaException class with the exception message specified.

Properties

Name Description
Data

Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
HelpLink

Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult

Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException

Gets the Exception instance that caused the current exception.

(Inherited from Exception)
LineNumber

Gets the line number indicating where the error occurred.

LinePosition

Gets the line position indicating where the error occurred.

Message

Gets the description of the error condition of this exception.

Source

Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
SourceSchemaObject

The XmlSchemaObject that produced the XmlSchemaException.

SourceUri

Gets the Uniform Resource Identifier (URI) location of the schema that caused the exception.

StackTrace

Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite

Gets the method that throws the current exception.

(Inherited from Exception)

Methods

Name Description
Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException()

When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext)
Obsolete.

Streams all the XmlSchemaException properties into the SerializationInfo class for the given StreamingContext.

GetType()

Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Creates and returns a string representation of the current exception.

(Inherited from Exception)

Events

Name Description
SerializeObjectState
Obsolete.

Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Applies to


Feedback

Was this page helpful?