System.Classes.TBinaryWriter.Create

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

Delphi

constructor Create; overload;
constructor Create(Stream: TStream); overload;
constructor Create(Stream: TStream; Encoding: TEncoding); overload;
constructor Create(Stream: TStream; Encoding: TEncoding; AOwnsStream: Boolean); overload;
constructor Create(const Filename: string; Append: Boolean = False); overload;
constructor Create(const Filename: string; Append: Boolean; Encoding: TEncoding); overload;

C++

__fastcall TBinaryWriter()/* overload */;
__fastcall TBinaryWriter(TStream* Stream)/* overload */;
__fastcall TBinaryWriter(TStream* Stream, System::Sysutils::TEncoding* Encoding)/* overload */;
__fastcall TBinaryWriter(TStream* Stream, System::Sysutils::TEncoding* Encoding, bool AOwnsStream)/* overload */;
__fastcall TBinaryWriter(const System::UnicodeString Filename, bool Append)/* overload */;
__fastcall TBinaryWriter(const System::UnicodeString Filename, bool Append, System::Sysutils::TEncoding* Encoding)/* overload */;

プロパティ

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

説明

TBinaryWriter のインスタンスを作成します。

Create を使用すると、TBinaryWriter インスタンスを作成し、インスタンス化することができます。

Create メソッドには、6 つのオーバーロード メソッドがあります:

  • 第 1 メソッドは、TBinaryWriter を null ストリームで作成します。
  • 第 2 メソッドには、パラメータ Stream があり、TBinaryWriter が書き込むストリームを表します。
  • 第 3 メソッドには、2 つのパラメータがあります:StreamTBinaryWriter が書き込むストリーム)と、Encoding ストリーム エンコーディングがあります。
  • 第 4 メソッドには、3 つのパラメータがあります: StreamTBinaryWriter が書き込むストリーム)と、Encoding ストリーム エンコーディング、および AOwnsStream です。AOwnsStream は、ストリームが TBinaryReader によって所有されているかどうか(つまり、他のクラスの他のインスタンスから使用されることが可能かどうか)を指定するために、使用されます。
  • 第 5 メソッドには、2 つのパラメータがあります: Filename はファイル名を表し、Append は書き込まれるデータを後ろに追加していくのかどうかを示します。このメソッドは、ファイル Filename のためのストリームを作成します。ファイルが見つからない場合には、例外が発生します。Append は、デフォルトでは、False です。
  • 第 6 メソッドには、3 つのパラメータがあります: Filename はファイル名を表し、Append は書き込まれるデータを後ろに追加していくのかどうかを示し、Encoding はファイルのエンコーディングを表します。このメソッドは、ファイル Filename のためのストリームを作成します。 ファイルが見つからない場合には、例外が発生します。

たとえば、ABinaryWriter TBinaryWriter インスタンス、および、エンコードが UTF8 のファイル AFile.dat がある場合、コードは次のようになります(Delphi の場合):

 
ABinaryWriter := TBinaryWriter.Create('AFile.dat',true,TEncoding.UTF8);

メモ: 文字列および文字を使用する場合、TEncoding.Unicode エンコーディングをしなければなりません。そうでなければ、TBinaryReader がストリームから読み込もうとした際に、例外が発生します。


関連項目

コード サンプル