FileSystem.WriteAllText メソッド

定義

名前空間:

Microsoft.VisualBasic.FileIO

アセンブリ:

Microsoft.VisualBasic.Core.dll

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

オーバーロード

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

WriteAllText(String, String, Boolean)

ソース:

FileSystem.vb

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

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 。

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

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

注意

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

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

終了	解決方法については、
ファイルへのテキストの書き込み	方法: ファイルにテキストを書き込む (Visual Basic)
ファイルへのテキストの追加	方法 : Visual Basic でテキスト ファイルに追記する

こちらもご覧ください

• Encoding
• WriteAllText

WriteAllText(String, String, Boolean, Encoding)

ソース:

FileSystem.vb

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

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

注釈

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

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

注意

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

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

終了	解決方法については、
ファイルへのテキストの書き込み	方法: ファイルにテキストを書き込む (Visual Basic)
ファイルへのテキストの追加	方法 : Visual Basic でテキスト ファイルに追記する

こちらもご覧ください

• Encoding