doctype Property

MSXML 5.0 SDK

Microsoft XML Core Services (MSXML) 5.0 for Microsoft Office - DOM Reference

doctype Property

Contains the document type node that specifies the document type definition (DTD) for this document.

[Script]

Script Syntax

var objXMLDOMDocumentType = oXMLDOMDocument.doctype;

Example

The following script example creates an IXMLDOMDocumentType object, and then displays the name property of the object.

var xmlDoc = new ActiveXObject("Msxml2.DOMDocument.5.0");
var MyDocType;
xmlDoc.async = false;
xmlDoc.load("books.xml");
if (xmlDoc.parseError.errorCode <> 0) {
   var myErr = xmlDoc.parseError;
   alert("You have error " + myErr.reason);
} else {
   MyDocType = xmlDoc.doctype;
   if (MyDocType != null) {
      alert(MyDocType.name);
   }
}
[Visual Basic]

Visual Basic Syntax

Set objXMLDOMDocumentType = oXMLDOMDocument.doctype

Example

The following Microsoft® Visual Basic® example creates an IXMLDOMDocumentType object, and then displays the name property of the object.

Dim xmlDoc As New Msxml2.DOMDocument50
Dim MyDocType As IXMLDOMDocumentType
xmlDoc.async = False
xmlDoc.Load ("books.xml")
If (xmlDoc.parseError.errorCode <> 0) Then
   Dim myErr
   Set myErr = xmlDoc.parseError
   MsgBox("You have error " & myErr.reason)
Else
   Set MyDocType = xmlDoc.doctype
   If Not MyDocType Is Nothing Then
      MsgBox MyDocType.Name
   End If
End If
[C/C++]

C/C++ Syntax

HRESULT get_doctype(
    IXMLDOMDocumentType **documentType);

Parameters

documentType [out, retval]
For XML, the address of the node of type NODE_DOCUMENT_TYPE that specifies the DTD. Returns Null for for HTML documents and XML documents without a DTD.

C/C++ Return Values

S_OK
The value returned if successful.
S_FALSE
The value returned when there is no document type node.
E_INVALIDARG
The value returned if the documentType parameter is Null.

Remarks

The property is read-only. For XML, it points to the node of type NODE_DOCUMENT_TYPE that specifies the DTD. It returns Null for HTML documents and XML documents without a DTD.

An XML document can contain a document type declaration before the first element in the document. It starts with the tag <!DOCTYPE> and can specify an external DTD.

To view reference information for Visual Basic, C/C++, or Script only, click the Language Filter button Language Filter in the upper-left corner of the page.

See Also

Applies to: DOMDocument |IXMLDOMDocumentType