IDOMImplementation.CreateDocument(String, String, IDocumentType) Method
Definition
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.
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.
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.