次の方法で共有


FileSystemProxy.WriteAllText メソッド

定義

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

オーバーロード

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 です。

例外

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

fileNothingです。

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

他のプロセスがファイルを使用しているか、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 SettingsFileList.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 示します。

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

こちらもご覧ください

適用対象

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 です。

例外

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

fileNothingです。

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

他のプロセスがファイルを使用しているか、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 SettingsFileList.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 示します。

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

こちらもご覧ください

適用対象