XmlWriter.WriteDocType Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

When overridden in a derived class, writes the DOCTYPE declaration with the specified name and optional attributes.

Namespace: System.Xml
Assembly: System.Xml (in System.Xml.dll)

Syntax

'Declaration
Public MustOverride Sub WriteDocType ( _
    name As String, _
    pubid As String, _
    sysid As String, _
    subset As String _
)

public abstract void WriteDocType(
    string name,
    string pubid,
    string sysid,
    string subset
)

pubid
Type: System.String
If non-null it also writes PUBLIC "pubid" "sysid" where pubid and sysid are replaced with the value of the given arguments.

sysid
Type: System.String
If pubid is nulla null reference (Nothing in Visual Basic) and sysid is non-null it writes SYSTEM "sysid" where sysid is replaced with the value of this argument.

subset
Type: System.String
If non-null it writes [subset] where subset is replaced with the value of this argument.

Exception	Condition
InvalidOperationException	This method was called outside the prolog (after the root element).
ArgumentException	The value for name would result in invalid XML.
XmlException	name is not valid.
NullReferenceException	The name, pubid, sysid, or subset parameter is nulla null reference (Nothing in Visual Basic).

This method does not check for invalid characters in pubid, sysid or subset. It also does not check that the internal subset is well-formed.

Security Note:
The XmlWriter does not validate the data that is passed to the WriteDocType method. You should not pass arbitrary data to this method.

Supported in: 5, 4, 3

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Supported in: Xbox 360, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.