API:FireDAC.Comp.DataSet.TFDBlobStream.Write
Delphi
function Write(const ABuffer; ACount: Longint): Longint; override;
function Write(const ABuffer: TBytes; AOffset, ACount: Longint): Longint; override;
C++
virtual int __fastcall Write(const void *ABuffer, int ACount)/* overload */;
virtual int __fastcall Write(const System::DynamicArray<System::Byte> ABuffer, int AOffset, int ACount)/* overload */;
inline int __fastcall Write(const System::DynamicArray<System::Byte> Buffer, int Count){ return System::Classes::TStream::Write(Buffer, Count); }
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | public | FireDAC.Comp.DataSet.pas FireDAC.Comp.DataSet.hpp |
FireDAC.Comp.DataSet | TFDBlobStream |
説明
Write メソッドは，Buffer から Count バイトのデータをメモリバッファの現在の位置に書き込み，Count バイト分だけ現在の位置を更新します。 {{#multireplace:FireDAC.Comp.DataSet.TFDBlobStream.Write|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} は {{#multireplace:System.Classes.TMemoryStream.Write|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を継承しています。以下の内容はすべて {{#multireplace:System.Classes.TMemoryStream.Write|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を参照しています。
Write メソッドは，Buffer から Count バイトのデータをメモリバッファの現在の位置に書き込み，Count バイト分だけ現在の位置を更新します。
Write メソッドを呼び出すと，Count バイトのデータをメモリストリームのメモリバッファの現在の位置から書き込むことができます。Write メソッドは，必要であればメモリバッファのサイズを増やしてデータを書き込みます。現在の位置がメモリバッファの最後ではない場合，Write メソッドは現在の位置以降のデータに上書きします。
Write は，Size プロパティを Position + Count に更新し，Position プロパティを Size の新しい値に設定します。そのため，メモリストリームで現在の位置から Count バイトに格納されていたすべてのデータは，Write メソッドの呼び出しで失われます。
Write メソッドは，メモリエラーがなければ必ず Count バイトのデータを Buffer に書き込みます。したがって，TMemoryStream オブジェクトでは，Write メソッドは WriteBuffer メソッドと同じ働きのメソッドです。
メモリストリームのほかのデータ書き込みメソッド（WriteBuffer，WriteComponent）は Write メソッドを呼び出して実際にデータを書き込みます。