System.IOUtils.TFile.WriteAllText

提供: RAD Studio API Documentation
移動先: 案内検索

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 は、ファイルにアクセスできない、またはパスが無効である場合などに、例外を発生させます。

関連項目

コード サンプル