Use this method to make sure all the data contained in the data model are stored on the client side (and that no subsquent call to the server will be necessary to access that data), at the cost of a higher memory consumption.
This method is useful in the following situations: <itemizedlist> <listitem><para>You need to disconnect from the server and continue to use the data in the data model</para></listitem> <listitem><para>You need to make sure the data in the data model can be used even though the connection to the server may be used for other purposes (for example executing other queries)</para></listitem> </itemizedlist>
Note that this method will fail if: <itemizedlist> <listitem><para>the data model contains any blobs (because blobs reading requires acces to the server); binary values are Ok, though.</para></listitem> <listitem><para>the data model has been modified since it was created</para></listitem> </itemizedlist>
this |
a DataSelect object |
true if no error occurred |