XmlWriter.WriteDocType-Methode
Schreibt beim Überschreiben in einer abgeleiteten Klasse die DOCTYPE-Deklaration mit dem angegebenen Namen und optionalen Attributen.
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 _
)
'Usage
Dim instance As XmlWriter
Dim name As String
Dim pubid As String
Dim sysid As String
Dim subset As String
instance.WriteDocType(name, pubid, sysid, subset)
public abstract void WriteDocType (
string name,
string pubid,
string sysid,
string subset
)
public:
virtual void WriteDocType (
String^ name,
String^ pubid,
String^ sysid,
String^ subset
) abstract
public abstract void WriteDocType (
String name,
String pubid,
String sysid,
String subset
)
public abstract function WriteDocType (
name : String,
pubid : String,
sysid : String,
subset : String
)
Parameter
- name
Der Name des DOCTYPE. Dieser darf nicht leer sein.
- pubid
Bei einem Wert ungleich NULL wird auch PUBLIC "pubid" "sysid" geschrieben, wobei pubid und sysid durch die Werte der angegebenen Argumente ersetzt werden.
- sysid
Wenn pubid gleich NULL (Nothing in Visual Basic) und sysid ungleich NULL ist, wird SYSTEM "sysid" geschrieben, wobei sysid durch den Wert dieses Arguments ersetzt wird.
- subset
Wenn nicht NULL, wird [subset] geschrieben, wobei subset durch den Wert dieses Arguments ersetzt wird.
Ausnahmen
Ausnahmetyp | Bedingung |
---|---|
Diese Methode wurde außerhalb des Prologs (nach dem Stammelement) aufgerufen. |
|
Der Wert für name würde zu ungültigem XML-Code führen. |
Hinweise
Diese Methode führt in pubid, sysid oder subset keine Überprüfung auf ungültige Zeichen aus. Sie überprüft außerdem nicht, ob die interne Teilmenge wohlgeformt ist.
Sicherheitshinweis |
---|
Der XmlWriter führt keine Validierung der an die WriteDocType-Methode übergebenen Daten durch. Sie sollten keine willkürlichen Daten an diese Methode übergeben. |
Hinweis zu Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows CE: Diese Methode wurde in Microsoft .NET Compact Framework, Version 1.0, nicht implementiert. Sie ist jedoch in Version 2.0 implementiert.
Beispiel
Im folgenden Beispiel wird eine XML-Datei geschrieben, die ein Buch darstellt.
Option Strict
Option Explicit
Imports System
Imports System.IO
Imports System.Xml
Public Class Sample
Private Const filename As String = "sampledata.xml"
Public Shared Sub Main()
Dim settings As XmlWriterSettings = new XmlWriterSettings()
settings.Indent = true
Dim writer As XmlWriter = XmlWriter.Create(filename, settings)
' Write the Processing Instruction node.
Dim PItext As String = "type=""text/xsl"" href=""book.xsl"""
writer.WriteProcessingInstruction("xml-stylesheet", PItext)
'Write the DocumentType node.
writer.WriteDocType("book", Nothing, Nothing, "<!ENTITY h ""hardcover"">")
' Write a Comment node.
writer.WriteComment("sample XML")
' Write the root element.
writer.WriteStartElement("book")
' Write the genre attribute
writer.WriteAttributeString("genre", "novel")
' Write the ISBN attribute.
writer.WriteAttributeString("ISBN", "1-8630-014")
' Write the title.
writer.WriteElementString("title", "The Handmaid's Tale")
' Write the style element.
writer.WriteStartElement("style")
writer.WriteEntityRef("h")
writer.WriteEndElement()
' Write the price.
writer.WriteElementString("price", "19.95")
' Write CDATA.
writer.WriteCData("Prices 15% off!!")
' Write the close tag for the root element.
writer.WriteEndElement()
writer.WriteEndDocument()
' Write the XML to file and close the writer
writer.Flush()
writer.Close()
End Sub 'Main
End Class 'Sample
using System;
using System.IO;
using System.Xml;
public class Sample {
private const string filename = "sampledata.xml";
public static void Main() {
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
XmlWriter writer = XmlWriter.Create(filename, settings);
// Write the Processing Instruction node.
String PItext="type=\"text/xsl\" href=\"book.xsl\"";
writer.WriteProcessingInstruction("xml-stylesheet", PItext);
// Write the DocumentType node.
writer.WriteDocType("book", null , null, "<!ENTITY h \"hardcover\">");
// Write a Comment node.
writer.WriteComment("sample XML");
// Write the root element.
writer.WriteStartElement("book");
// Write the genre attribute.
writer.WriteAttributeString("genre", "novel");
// Write the ISBN attribute.
writer.WriteAttributeString("ISBN", "1-8630-014");
// Write the title.
writer.WriteElementString("title", "The Handmaid's Tale");
// Write the style element.
writer.WriteStartElement("style");
writer.WriteEntityRef("h");
writer.WriteEndElement();
// Write the price.
writer.WriteElementString("price", "19.95");
// Write CDATA.
writer.WriteCData("Prices 15% off!!");
// Write the close tag for the root element.
writer.WriteEndElement();
writer.WriteEndDocument();
// Write the XML to file and close the writer.
writer.Flush();
writer.Close();
}
}
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
XmlWriter-Klasse
XmlWriter-Member
System.Xml-Namespace