指定したファイルを使用して、XmlTextWriter クラスのインスタンスを作成します。
名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文
'宣言
Public Sub New ( _
filename As String, _
encoding As Encoding _
)
'使用
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
)
パラメータ
- filename
書き込むファイル名。ファイルが存在する場合は、ファイルを切り詰め、新しい内容で上書きします。
- encoding
生成するエンコーディング。エンコーディングが null 参照 (Visual Basic では Nothing) の場合は、ファイルを UTF-8 として書き込み、ProcessingInstruction からエンコーディング属性を省略します。
例外
| 例外の種類 | 条件 |
|---|---|
エンコーディングがサポートされていません。ファイル名が空で、空白しか含んでいないか、無効な文字を 1 つ以上含んでいます。 |
|
アクセスが拒否されました。 |
|
ファイル名が null 参照 (Visual Basic では Nothing) です。 |
|
書き込むディレクトリが見つかりません。 |
|
ファイル名には、ファイル名、ディレクトリ名、またはボリューム ラベルの不正な構文または無効な構文が含まれています。 |
|
呼び出し元に、必要なアクセス許可がありません。 |
解説
注意
Microsoft .NET Framework version 2.0 リリースでは、System.Xml.XmlWriter.Create メソッドと XmlWriterSettings クラスを使用して XmlWriter インスタンスを作成することをお勧めします。これにより、このリリースで導入されたすべての新機能を十分に活用できます。詳細については、「XML ライタの作成」を参照してください。
プラットフォーム
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0