Freigeben über


XmlTextWriter-Konstruktor (String, Encoding)

Erstellt mithilfe der angegebenen Datei eine Instanz der XmlTextWriter-Klasse.

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

Syntax

'Declaration
Public Sub New ( _
    filename As String, _
    encoding As Encoding _
)
'Usage
Dim filename As String
Dim encoding As Encoding

Dim instance As New XmlTextWriter(filename, encoding)
public XmlTextWriter (
    string filename,
    Encoding encoding
)
public:
XmlTextWriter (
    String^ filename, 
    Encoding^ encoding
)
public XmlTextWriter (
    String filename, 
    Encoding encoding
)
public function XmlTextWriter (
    filename : String, 
    encoding : Encoding
)

Parameter

  • filename
    Der Name der Datei, in die geschrieben werden soll. Wenn die Datei vorhanden ist, wird diese abgeschnitten und mit dem neuen Inhalt überschrieben.
  • encoding
    Die zu generierende Codierung. Wenn die Codierung NULL (Nothing in Visual Basic) ist, wird die Datei UTF-8-codiert ausgegeben, und das Codierungsattribut der ProcessingInstruction wird nicht berücksichtigt.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentException

Die Codierung wird nicht unterstützt; der Dateiname ist leer oder enthält nur Leerraum bzw. ein oder mehrere ungültige(s) Zeichen.

UnauthorizedAccessException

Zugriff wird verweigert.

ArgumentNullException

Der Dateiname ist NULL (Nothing in Visual Basic).

DirectoryNotFoundException

Das Verzeichnis, in das geschrieben werden soll, wurde nicht gefunden.

IOException

Der Dateiname enthält eine falsche oder ungültige Syntax für den Dateinamen, Verzeichnisnamen oder die Datenträgerbezeichnung.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Hinweise

Hinweis

Die empfohlene Vorgehensweise für die Version Microsoft .NET Framework, Version 2.0 besteht darin, mithilfe der System.Xml.XmlWriter.Create-Methode und der XmlWriterSettings-Klasse XmlWriter-Instanzen zu erstellen. So können Sie alle neuen Features dieser Version in vollem Umfang nutzen. Weitere Informationen finden Sie unter Erstellen von XML-Writern.

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

XmlTextWriter-Klasse
XmlTextWriter-Member
System.Xml-Namespace