System.Classes.TFileStream.Create

提供:RAD Studio API Documentation

Delphi

constructor Create(const AFileName: string; Mode: Word); overload;
constructor Create(const AFileName: string; Mode: Word; Rights: Cardinal); overload;

C++

__fastcall TFileStream(const System::UnicodeString AFileName, System::Word Mode)/* overload */;
__fastcall TFileStream(const System::UnicodeString AFileName, System::Word Mode, unsigned Rights)/* overload */;

プロパティ

種類 可視性 ソース ユニット 親
constructor public
System.Classes.pas
System.Classes.hpp
System.Classes TFileStream


説明

Create は、TFileStream のインスタンスを作成します。

Create を呼び出すと、名前のつけられたファイルに対して読み書きを行う、ファイル ストリームをインスタンス化することができます。 ファイルの名前と、ファイルの開く方法を、パラメータとして指定します。

Mode パラメータは、ファイルを開く方法を示します。 Mode パラメータは、オープン モードと(可能な場合の)共有モードを表す識別子を or で結んで指定します。 オープン モードには、次のいずれかの値を指定します。

値 意味 宣言箇所

fmCreate

指定した名前でファイルを作成します。 指定された名前のファイルが存在する場合、既存のファイルを上書きし、それを書き込みモードで開く。

System.Classes

fmExclusive

ファイルを存在しない場合にのみ、自動的に作成し、そうでなければ失敗します。

System.Classes

fmOpenRead

読み取り専用でファイルを開きます。

System.SysUtils

fmOpenWrite

書き込み専用でファイルを開きます。 ファイルへの書き込みにより、現在の内容は完全に置き換えられます。

System.SysUtils

fmOpenReadWrite

ファイルを開き、現在の内容を置き換えるのではなく、変更する。

System.SysUtils


共有モードは、次のいずれかの値となります:

値 意味 宣言箇所

fmShareCompat

共有は、FCB が開かれる方法と互換性がある。

System.SysUtils

fmShareExclusive

他のアプリケーションは、いかなる理由でもファイルを開くことはできない。

System.SysUtils

fmShareDenyWrite

他のアプリケーションは、ファイルを読み取り用に開くことはできるが、書き込み用に開くことはできない。

System.SysUtils

fmShareDenyRead

他のアプリケーションは、書き込みのためにはファイルを開けるが、読み取りのためにはできない。

System.SysUtils

fmShareDenyNone

他のアプリケーションによるファイルの読み取りおよび書き込みを回避する処理は行われない。

System.SysUtils

メモ: Rights パラメータは、Mode に fmCreate が含まれている際に、Windows 以外のプラットフォームで使用されます。詳細については、プラットフォーム専用の “open” システムコールの説明を参照してください。例: Linux マニュアル ページ

ファイルを開くことができない場合、Create は例外を発生させます。

関連項目

コード サンプル