XmlWriter::WriteDocType Method (String^, String^, String^, String^)
When overridden in a derived class, writes the DOCTYPE declaration with the specified name and optional attributes.
Assembly: System.Xml (in System.Xml.dll)
public: virtual void WriteDocType( String^ name, String^ pubid, String^ sysid, String^ subset ) abstract
Parameters
- name
-
Type:
System::String^
The name of the DOCTYPE. This must be non-empty.
- 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 null 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. |
| InvalidOperationException | An XmlWriter method was called before a previous asynchronous operation finished. In this case, InvalidOperationException is thrown with the message “An asynchronous operation is already in progress.” |
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. |
For the asynchronous version of this method, see WriteDocTypeAsync.
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
