FileSystem.WriteAllText メソッド

定義

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

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

オーバーロード

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

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

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

WriteAllText(String, String, Boolean)

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

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

パラメーター

file
String

書き込むファイル。

text
String

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

append
Boolean

True ファイルの内容に追加する場合。ファイルの内容を上書きする 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 メソッドに関連するタスクの例を示します。

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

こちらもご覧ください

適用対象

WriteAllText(String, String, Boolean, Encoding)

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

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

パラメーター

file
String

書き込むファイル。

text
String

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

append
Boolean

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

encoding
Encoding

ファイルに書き込むときに使用するエンコード。

例外

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 メソッドに関連するタスクの例を示します。

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

こちらもご覧ください

適用対象