FileSystem.WriteAllText メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ファイルにテキストを書き込みます。
オーバーロード
| WriteAllText(String, String, Boolean) |
ファイルにテキストを書き込みます。 |
| WriteAllText(String, String, Boolean, Encoding) |
ファイルにテキストを書き込みます。 |
WriteAllText(String, String, Boolean)
- ソース:
- FileSystem.vb
- ソース:
- FileSystem.vb
- ソース:
- 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 -> unitPublic Shared Sub WriteAllText (file As String, text As String, append As Boolean)パラメーター
- file
- String
書き込み先のファイル。
- text
- String
ファイルに書き込まれるテキスト。
- append
- Boolean
ファイルの内容を追記する場合は True。ファイルの内容を上書きする場合は False。
例外
パスは、次のいずれかの理由で無効です。長さが 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パスです (\\.\で始まります)。末尾にスラッシュが付きます。
file が Nothingです。
ファイルが存在しません。
他のプロセスがファイルを使用しているか、I/O エラーが発生しました。
パスがシステム定義の最大長を超えています。
パス内のファイル名またはディレクトリ名にコロン (:) が含まれているか、形式が無効です。
文字列をバッファーに書き込むための十分なメモリがありません。
ユーザーがパスを参照するのに必要なアクセス許可を保持していません。
例
次の使用例は、ファイルに行 "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 でテキスト ファイルに追記する |
こちらもご覧ください
適用対象
WriteAllText(String, String, Boolean, Encoding)
- ソース:
- FileSystem.vb
- ソース:
- FileSystem.vb
- ソース:
- 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 -> unitPublic 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
ファイルへの書き込み時に使用するエンコーディングを指定します。
例外
パスは、次のいずれかの理由で無効です。長さが 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パスです (\\.\で始まります)。末尾にスラッシュが付きます。
file が Nothingです。
ファイルが存在しません。
他のプロセスがファイルを使用しているか、I/O エラーが発生しました。
パスがシステム定義の最大長を超えています。
パス内のファイル名またはディレクトリ名にコロン (:) が含まれているか、形式が無効です。
文字列をバッファーに書き込むための十分なメモリがありません。
ユーザーがパスを参照するのに必要なアクセス許可を保持していません。
例
次の使用例は、ファイルに行 "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 でテキスト ファイルに追記する |
こちらもご覧ください
適用対象
.NET