FireDAC.Comp.Client.TFDCustomConnection.Offlined

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property Offlined: Boolean read FOfflined write SetOfflined default False;

C++

__property bool Offlined = {read=FOfflined, write=SetOfflined, default=0};

Propriétés

Type Visibilité  Source Unité  Parent
property public
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDCustomConnection

Description

Obtient ou définit le statut hors ligne de la connexion.

Définissez Offlined sur True pour basculer la connexion, les commandes et les ensembles de données associés sur le mode hors ligne. En mode hors ligne, la connexion à un SGBD est fermée, mais les ensembles de données restent ouverts.

Si un ensemble de données associé à cet objet connexion est actif et que les enregistrements ne sont pas tous récupérés du curseur SGBD, alors en fonction de la valeur FetchOptions.AutoFetchAll, les actions suivantes sont exécutées :

  • afAll (mode par défaut) -- l'ensemble de données récupère tous les enregistrements du curseur et se met en mode hors ligne.
  • afTruncate -- l'ensemble de données tronque l'ensemble de résultats et se met en mode hors ligne.
  • afDisable -- une exception est déclenchée.

Si l'application essaie d'effectuer, sur une commande ou sur les objets d'un ensemble de données, une opération nécessitant une connexion SGBD, puis si ResourceOptions.AutoConnect est défini sur True, la connexion établira automatiquement une connexion au SGBD. C'est le mode par défaut Si ResourceOptions.AutoConnect est défini sur False, l'objet connexion déclenchera alors une exception.

Définissez Offlined sur False pour établir une connexion avec le SGBD et basculer en mode en ligne.

Voir aussi