System.IOUtils.TFile.WriteAllText
Delphi
class procedure WriteAllText(const Path, Contents: string); overload; static;
class procedure WriteAllText(const Path, Contents: string; const Encoding: TEncoding); overload; static;
C++
static void __fastcall WriteAllText(const System::UnicodeString Path, const System::UnicodeString Contents)/* overload */;
static void __fastcall WriteAllText(const System::UnicodeString Path, const System::UnicodeString Contents, System::Sysutils::TEncoding* const Encoding)/* overload */;
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
procedure function |
public | System.IOUtils.pas System.IOUtils.hpp |
System.IOUtils | TFile |
説明
指定された Contents
テキストをエンコードし、取得したテキストを Path
テキスト ファイルに書き込みます。
パラメータを 1 つ取る WriteAllText は、まず Path
ファイルを作成し、指定された Contents
文字列を UTF8 エンコーディングを使用してエンコードし、その後、エンコードされた文字列を作成されたテキスト ファイルに書き込みます。
パラメータを 2 つ取る WriteAllText は、まず Path
ファイルを作成し、指定された Encoding
エンコーディングを記述するプリアンブル部を作成されたファイルに書き込み、指定された Contents
文字列を指定された Encoding
エンコーディングを使用してエンコードし、その後、エンコードされた文字列を Path
ファイルに追記します。
Path
パラメータによって指定されるファイルが存在する場合、それは上書きされ、そうでなければ、ファイルは作成され、指定されたテキストが入れられます。
WriteAllText には次のパラメータがあります:
Path
は、ファイルへのパスです。Contents
は、書き込みされるテキストを格納する文字列です。Encoding
は、テキストで使用されるエンコーディングです。
メモ: プリアンブル部は、使用されるエンコーディングを指定するバイトのシーケンスです。 これは、バイト順マーク(BOM)と呼ばれます。
メモ: WriteAllText は、ファイルにアクセスできない、またはパスが無効である場合などに、例外を発生させます。
関連項目
- System.SysUtils.TEncoding
- System.SysUtils.TEncoding.UTF8
- OpenText
- AppendAllText
- ReadAllText
- System.SysUtils.TEncoding.GetBufferEncoding
- Encoding.GetPreamble (MSDN)
- バイト オーダー マーク(BOM)