FileSystemProxy.WriteAllText メソッド

定義

名前空間:
Microsoft.VisualBasic.MyServices
アセンブリ:
Microsoft.VisualBasic.dll

ファイルにテキストを書き込みます。

オーバーロード

名前 説明
WriteAllText(String, String, Boolean)

ファイルにテキストを書き込みます。
WriteAllText(String, String, Boolean, Encoding)

ファイルにテキストを書き込みます。

WriteAllText(String, String, Boolean)

ファイルにテキストを書き込みます。

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append);
public void WriteAllText(string file, string text, bool append);
member this.WriteAllText : string * string * bool -> unit
Public Sub WriteAllText (file As String, text As String, append As Boolean)

パラメーター

file
String

書き込むファイル。

text
String

ファイルに書き込むテキスト。

append
Boolean

True ファイルの内容に追加する場合。ファイルの内容を上書きする False します。 既定値は False です。

例外

ArgumentException

パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白のみを含みます。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。末尾にスラッシュが付きます。

ArgumentNullException

file は Nothingです。

FileNotFoundException

ファイルが存在しません。

IOException

ファイルが別のプロセスで使用されているか、I/O エラーが発生します。

PathTooLongException

パスがシステム定義の最大長を超えています。

NotSupportedException

パス内のファイル名またはディレクトリ名にコロン (:)または無効な形式が含まれています。

OutOfMemoryException

バッファーに文字列を書き込むのに十分なメモリがありません。

SecurityException

ユーザーには、パスを表示するために必要なアクセス許可がありません。

例

次の使用例は、 "This is new text to be added." 行をファイル Test.txtに書き込み、ファイル内の既存のテキストを上書きします。

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

次の使用例は、 Documents and Settings フォルダー内のファイルの名前を FileList.txtに書き込み、読みやすくするためにそれぞれの間に復帰を挿入します。

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

注釈

UTF-8 エンコードは、ファイルへの書き込みに使用されます。 別のエンコードを指定するには、 WriteAllText メソッドの別のオーバーロードを使用します。

指定したファイルが存在しない場合は作成されます。

指定したエンコードがファイルの既存のエンコードと一致しない場合、指定したコーディングは無視されます。

Note

WriteAllText メソッドは、ファイルを開き、ファイルに書き込んでから閉じます。 WriteAllText メソッドを使用するコードは、StreamWriter オブジェクトを使用するコードよりも簡単です。 ただし、ループを使用してファイルに文字列を追加する場合は、ファイルを 1 回だけ開いたり閉じたりするだけで済むため、 StreamWriter オブジェクトのパフォーマンスが向上する可能性があります。 詳細については、 OpenTextFileWriter メソッドを参照してください。

次の表に、 My.Computer.FileSystem.WriteAllText メソッドに関連するタスクの例を示します。

ターゲット 参照先
ファイルにテキストを書き込む 方法: ファイルにテキストを書き込む
ファイルにテキストを追加する 方法: テキスト ファイルに追加する

こちらもご覧ください

適用対象

WriteAllText(String, String, Boolean, Encoding)

ファイルにテキストを書き込みます。

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);
public void WriteAllText(string file, string text, bool append, System.Text.Encoding encoding);
member this.WriteAllText : string * string * bool * System.Text.Encoding -> unit
Public Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)

パラメーター

file
String

書き込むファイル。

text
String

ファイルに書き込むテキスト。

append
Boolean

True ファイルの内容に追加する場合。ファイルの内容を上書きする False します。 既定値は False です。

encoding
Encoding

ファイルに書き込むときに使用するエンコード。 既定値は UTF-8 です。

例外

ArgumentException

パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白のみを含みます。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。末尾にスラッシュが付きます。

ArgumentNullException

file は Nothingです。

FileNotFoundException

ファイルが存在しません。

IOException

ファイルが別のプロセスで使用されているか、I/O エラーが発生します。

PathTooLongException

パスがシステム定義の最大長を超えています。

NotSupportedException

パス内のファイル名またはディレクトリ名にコロン (:)または無効な形式が含まれています。

OutOfMemoryException

バッファーに文字列を書き込むのに十分なメモリがありません。

SecurityException

ユーザーには、パスを表示するために必要なアクセス許可がありません。

例

次の使用例は、 "This is new text to be added." 行をファイル Test.txtに書き込み、ファイル内の既存のテキストを上書きします。

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

次の使用例は、 Documents and Settings フォルダー内のファイルの名前を FileList.txtに書き込み、読みやすくするためにそれぞれの間に復帰を挿入します。

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

注釈

指定したファイルが存在しない場合は作成されます。

指定したエンコードがファイルの既存のエンコードと一致しない場合、指定したコーディングは無視されます。

Note

WriteAllText メソッドは、ファイルを開き、ファイルに書き込んでから閉じます。 WriteAllText メソッドを使用するコードは、StreamWriter オブジェクトを使用するコードよりも簡単です。 ただし、ループを使用してファイルに文字列を追加する場合は、ファイルを 1 回だけ開いたり閉じたりするだけで済むため、 StreamWriter オブジェクトのパフォーマンスが向上する可能性があります。 詳細については、 OpenTextFileWriter メソッドを参照してください。

次の表に、 My.Computer.FileSystem.WriteAllText メソッドに関連するタスクの例を示します。

ターゲット 参照先
ファイルにテキストを書き込む 方法: ファイルにテキストを書き込む
ファイルにテキストを追加する 方法: テキスト ファイルに追加する

こちらもご覧ください

適用対象