XmlDocument Constructors

Reference

Definition

Namespace:: System.Xml

Assemblies:: System.Xml.dll, System.Xml.XmlDocument.dll

Assemblies:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XmlDocument.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

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.

Initializes a new instance of the XmlDocument class.

Overloads

XmlDocument()	Initializes a new instance of the XmlDocument class.
XmlDocument(XmlImplementation)	Initializes a new instance of the `XmlDocument` class with the specified XmlImplementation.
XmlDocument(XmlNameTable)	Initializes a new instance of the `XmlDocument` class with the specified XmlNameTable.

XmlDocument()

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Initializes a new instance of the XmlDocument class.

public:
 XmlDocument();

public XmlDocument();

Public Sub New ()

Examples

The following is an example of load-time validation. A document type definition (DTD) validating XmlReader is passed to the Load method and a ValidationEventHandler is provided to notify users of any validation errors. In this example a validation error is found, but the document is still loaded. Alternatively, you can define a validating XmlReader to throw an exception and stop the load process when a validation error is found by not specifying the ValidationEventHandler. For more information about validating XML data, see the Remarks section of the XmlReader reference page.

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
using namespace System::Xml::Schema;

ref class XmlDocumentSample
{
private:
    static XmlReader^ reader;
    static String^ filename = "bookdtd.xml";

    // Display the validation error.
    static void ValidationCallback(Object^ sender, ValidationEventArgs^ args)
    {
        Console::WriteLine("Validation error loading: {0}", filename);
        Console::WriteLine(args->Message);
    }

public:
    static void Main()
    {
        ValidationEventHandler^ eventHandler = gcnew ValidationEventHandler(XmlDocumentSample::ValidationCallback);

        try
        {
            // Create the validating reader and specify DTD validation.
            XmlReaderSettings^ settings = gcnew XmlReaderSettings();
                        settings->DtdProcessing = DtdProcessing::Parse;
            settings->ValidationType = ValidationType::DTD;
            settings->ValidationEventHandler += eventHandler;

            reader = XmlReader::Create(filename, settings);

            // Pass the validating reader to the XML document.
            // Validation fails due to an undefined attribute, but the 
            // data is still loaded into the document.
            XmlDocument^ doc = gcnew XmlDocument();
            doc->Load(reader);
            Console::WriteLine(doc->OuterXml);
        }
        finally
        {
            if (reader != nullptr)
                reader->Close();
        }
    }
};

int main()
{
    XmlDocumentSample::Main();
    return 0;
}

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

namespace Microsoft.Samples.Xml
{
    sealed class XmlDocumentSample
    {
        private XmlDocumentSample() { }

        static XmlReader reader;
        static String filename = "bookdtd.xml";

        public static void Main()
        {

            ValidationEventHandler eventHandler = new ValidationEventHandler(XmlDocumentSample.ValidationCallback);

            try
            {
                // Create the validating reader and specify DTD validation.
                XmlReaderSettings settings = new XmlReaderSettings();
                settings.DtdProcessing = DtdProcessing.Parse;
                settings.ValidationType = ValidationType.DTD;
                settings.ValidationEventHandler += eventHandler;

                reader = XmlReader.Create(filename, settings);

                // Pass the validating reader to the XML document.
                // Validation fails due to an undefined attribute, but the
                // data is still loaded into the document.
                XmlDocument doc = new XmlDocument();
                doc.Load(reader);
                Console.WriteLine(doc.OuterXml);
            }
            finally
            {
                if (reader != null)
                    reader.Close();
            }
        }

        // Display the validation error.
        private static void ValidationCallback(object sender, ValidationEventArgs args)
        {
            Console.WriteLine("Validation error loading: {0}", filename);
            Console.WriteLine(args.Message);
        }
    }
}

Option Explicit On
Option Strict On

Imports System.Xml
Imports System.Xml.Schema

Namespace Microsoft.Samples.Xml

    NotInheritable Class XmlDocumentSample

        Private Sub New()

        End Sub

        Shared reader As XmlReader
        Shared filename As String = "bookdtd.xml"

        Public Shared Sub Main()


            Dim eventHandler As New ValidationEventHandler(AddressOf XmlDocumentSample.ValidationCallback)

            Try

                ' Create the validating reader and specify DTD validation.
                Dim settings As New XmlReaderSettings()
                settings.DtdProcessing = DtdProcessing.Parse
                settings.ValidationType = ValidationType.DTD
                AddHandler settings.ValidationEventHandler, eventHandler

                reader = XmlReader.Create(filename, settings)

                ' Pass the validating reader to the XML document.
                ' Validation fails due to an undefined attribute, but the 
                ' data is still loaded into the document.
                Dim doc As New XmlDocument()
                doc.Load(reader)
                Console.WriteLine(doc.OuterXml)
            
            Finally

                If Not (reader Is Nothing) Then
                    reader.Close()
                End If

            End Try

        End Sub

        ' Display the validation error.
        Private Shared Sub ValidationCallback(ByVal sender As Object, ByVal args As ValidationEventArgs)
            Console.WriteLine("Validation error loading: {0}", filename)
            Console.WriteLine(args.Message)
        End Sub

    End Class
End Namespace

The example uses the bookDTD.xml file as input.

XML

<!DOCTYPE bookstore [
  <!ELEMENT bookstore (book)*> 
  <!ELEMENT book (title,author,price)>
  <!ATTLIST book genre CDATA #REQUIRED>
  <!ELEMENT title (#PCDATA)>
  <!ELEMENT author (#PCDATA)>
  <!ELEMENT price (#PCDATA)>]>
<bookstore>
  <book genre="fantasy"  ISBN="2-3631-4">
    <title>Oberon's Legacy</title>
    <author>Corets, Eva</author>
    <price>5.95</price>
  </book>
</bookstore>

Applies to

.NET 10 a ďalšie verzie

Produkt	Verzie
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1
UWP	10.0

XmlDocument(XmlImplementation)

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Initializes a new instance of the XmlDocument class with the specified XmlImplementation.

protected public:
 XmlDocument(System::Xml::XmlImplementation ^ imp);

protected internal XmlDocument(System.Xml.XmlImplementation imp);

new System.Xml.XmlDocument : System.Xml.XmlImplementation -> System.Xml.XmlDocument

Protected Friend Sub New (imp As XmlImplementation)

Parameters

imp: XmlImplementation

The XmlImplementation to use.

Applies to

.NET 10 a ďalšie verzie

Produkt	Verzie
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1
UWP	10.0

XmlDocument(XmlNameTable)

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Initializes a new instance of the XmlDocument class with the specified XmlNameTable.

public:
 XmlDocument(System::Xml::XmlNameTable ^ nt);

public XmlDocument(System.Xml.XmlNameTable nt);

new System.Xml.XmlDocument : System.Xml.XmlNameTable -> System.Xml.XmlDocument

Public Sub New (nt As XmlNameTable)

Parameters

nt: XmlNameTable

The XmlNameTable to use.

Applies to

.NET 10 a ďalšie verzie

Produkt	Verzie
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1
UWP	10.0

Zdieľať cez

XmlDocument Constructors

Definition

Overloads

XmlDocument()

Examples

See also

Applies to

XmlDocument(XmlImplementation)

Parameters

Applies to

XmlDocument(XmlNameTable)

Parameters

Applies to

Ďalšie zdroje informácií