Share via


IDOMImplementation.CreateDocument(String, String, IDocumentType) Method

Definition

Creates a DOM Document object of the specified type with its document element.

[Android.Runtime.Register("createDocument", "(Ljava/lang/String;Ljava/lang/String;Lorg/w3c/dom/DocumentType;)Lorg/w3c/dom/Document;", "GetCreateDocument_Ljava_lang_String_Ljava_lang_String_Lorg_w3c_dom_DocumentType_Handler:Org.W3c.Dom.IDOMImplementationInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.W3c.Dom.IDocument? CreateDocument (string? namespaceURI, string? qualifiedName, Org.W3c.Dom.IDocumentType? doctype);
[<Android.Runtime.Register("createDocument", "(Ljava/lang/String;Ljava/lang/String;Lorg/w3c/dom/DocumentType;)Lorg/w3c/dom/Document;", "GetCreateDocument_Ljava_lang_String_Ljava_lang_String_Lorg_w3c_dom_DocumentType_Handler:Org.W3c.Dom.IDOMImplementationInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member CreateDocument : string * string * Org.W3c.Dom.IDocumentType -> Org.W3c.Dom.IDocument

Parameters

namespaceURI
String

The namespace URI of the document element to create or null.

qualifiedName
String

The qualified name of the document element to be created or null.

doctype
IDocumentType

The type of document to be created or null. When doctype is not null, its Node.ownerDocument attribute is set to the document being created.

Returns

A new Document object with its document element. If the NamespaceURI, qualifiedName, and doctype are null, the returned Document is empty with no document element.

Attributes

Exceptions

INVALID_CHARACTER_ERR: Raised if the specified qualified name is not an XML name according to [].
NAMESPACE_ERR: Raised if the qualifiedName is malformed, if the qualifiedName has a prefix and the namespaceURI is null, or if the qualifiedName is null and the namespaceURI is different from null, or if the qualifiedName has a prefix that is "xml" and the namespaceURI is different from "" [] , or if the DOM implementation does not support the "XML" feature but a non-null namespace URI was provided, since namespaces were defined by XML.
WRONG_DOCUMENT_ERR: Raised if doctype has already been used with a different document or was created from a different implementation.
NOT_SUPPORTED_ERR: May be raised if the implementation does not support the feature "XML" and the language exposed through the Document does not support XML Namespaces (such as []).

Remarks

Creates a DOM Document object of the specified type with its document element. <br>Note that based on the DocumentType given to create the document, the implementation may instantiate specialized Document objects that support additional features than the "Core", such as "HTML" [DOM Level 2 HTML] . On the other hand, setting the DocumentType after the document was created makes this very unlikely to happen. Alternatively, specialized Document creation methods, such as createHTMLDocument [DOM Level 2 HTML] , can be used to obtain specific types of Document objects.

Added in DOM Level 2.

Java documentation for org.w3c.dom.DOMImplementation.createDocument(java.lang.String, java.lang.String, org.w3c.dom.DocumentType).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to