Data.Win.ADODB.TCustomADODataSet.SaveToFile

From RAD Studio API Documentation
Jump to: navigation, search

[–] Properties
Type:
procedure
function
Visibility: public
Source:
Data.Win.ADODB.pas
Data.Win.ADODB.hpp
Unit: Data.Win.ADODB
Parent: TCustomADODataSet

Delphi

procedure SaveToFile(const FileName: WideString = ''; Format: TPersistFormat = pfADTG);

C++

void __fastcall SaveToFile(const System::WideString FileName = System::WideString(), TPersistFormat Format = (TPersistFormat)(0x0));

Description

Saves a recordset to a file.

Call SaveToFile to save the current recordset to a file. If the destination file already exists, it is overwritten.

FileName is a string containing the name of the destination file. This file remains open from the first call to SaveToFile until the dataset is closed. This file can be read by other applications while it is open, but they cannot write to the file.

Format specifies the file format for the saved recordset. By default, Format is pfADTG (Advanced Data TableGram format).

Note: Microsoft recommends using a client-side cursor (the dataset is opened with a CursorLocation property value of clUseClient). This way, if the provider used does not support saving the recordset the client cursor will provide the necessary functionality.

See Also