Data.DBXCommon.TDBXPropertyNames

De RAD Studio API Documentation
Aller à : navigation, rechercher

System.TObjectTDBXPropertyNames

Delphi

TDBXPropertyNames = class

C++

class PASCALIMPLEMENTATION TDBXPropertyNames : public System::TObject

Propriétés

Type Visibilité  Source Unité  Parent
class public
Data.DBXCommon.pas
Data.DBXCommon.hpp
Data.DBXCommon Data.DBXCommon


Description

Noms de propriétés utilisés pour les connexions et les pilotes afin de fournir des informations, comme les noms d'utilisateurs et les mots de passe.

Le tableau suivant décrit les noms de propriété existants :

Constante Description

AutoUnloadDriver

Si définie sur True, les pilotes à liaison dynamique déchargent automatiquement leur DLL lorsqu'il ne reste plus aucune connexion ouverte qui utilise le pilote.

BufferKBSize

Taille du tampon en kilo-octets pour l'utilisation des opérations de lecture/écriture de transport du pilote client. Actuellement utilisée par Data.DBXClient.

CommunicationIPVersion

Spécifie la version IP pour les communications.

CommunicationProtocol

Spécifie le protocole de communication.

CommunicationTimeout

Spécifie le temps d'attente maximal pour l'échange d'un paquet de données. Lorsque le temps spécifié expire, une exception est déclenchée. Tous les pilotes ne prennent pas en charge cette opération.

ConnectionName

Nom de la connexion. Si les propriétés de connexion sont lues dans le fichier dbxconnections.ini, c'est le nom de la section du fichier ini. Le client AdoDbx peut utiliser cette définition de propriété pour une simple chaîne de connexion. Les noms de connexion peuvent également être utilisés pour charger une connexion à partir d'une instance de TDBXConnectionFactory.

ConnectionString

Chaîne qui fournit les informations dont le protocole a besoin pour établir la connexion.

ConnectTimeout

Temps d'attente maximal, en secondes, pour l'ouverture d'une nouvelle connexion. Si le temps spécifié expire, une exception est déclenchée. Tous les pilotes ne prennent pas en charge cette opération.

Database

Nom d'une base de données pour connexion.

DatasnapContext

Spécifie une clé pour un chemin URL vers un service HTTP DataSnap.

DBHostName

Nom d'hôte de la machine qui héberge la base de données.

DelegateConnection

La connexion déléguée utilisée par cette connexion. Les connexions déléguées implémentent le framework de pilotes dbExpress 4. Elles peuvent effectuer des pré ou des post-traitements de toutes les méthodes protégées et publiques avant de déléguer à la connexion réelle ou à une autre connexion déléguée.

DelegateDriver

Indique que ce pilote est un délégué et qu'il peut seulement être utilisé conjointement avec un pilote non délégué.

DisplayDriverName

Affiche le nom du pilote.

DriverAssembly
(obsolète)

Utilisée pour charger un pilote géré dynamiquement.

Remarque : Il est préférable d'ajouter une virgule plus le nom de package à la fin du paramètre DriverPackageLoader au lieu d'utiliser DriverAssembly.

DriverAssemblyLoader

Classe du chargeur du pilote géré qui est utilisée pour charger un pilote géré dynamiquement à partir d'un assemblage. La classe et le nom du package sont séparés par une virgule.

DriverName

Nom unique d'un pilote dbExpress. Utilisé par le fichier dbxconnections.ini pour faire référence à un pilote de connexion dans le fichier dbxdrivers.ini.

DriverPackage
(obsolète)

Utilisé pour charger un pilote natif dynamiquement.

Remarque : Il est préférable d'ajouter une virgule plus le nom de package à la fin du paramètre DriverPackageLoader au lieu d'utiliser DriverPackage.

DriverPackageLoader

La classe du chargeur du pilote natif utilisée pour charger un pilote natif dynamiquement à partir d'un package. La classe et le nom du package sont séparés par une virgule.

DriverUnit

Utilisé pour fournir un message d'erreur informatif lorsque le pilote ne peut pas être chargé.

DSAuthenticationPassword

Spécifie un mot de passe requis pour qu'un utilisateur DataSnap puisse s'authentifier sur le serveur.

DSAuthenticationScheme

Spécifie le schéma d'URL à utiliser pour établir la connexion au serveur DataSnap à des fins d'authentification.

DSAuthenticationUser

Spécifie le nom d'utilisateur reconnu par le serveur DataSnap. Ne pas confondre avec l'utilisateur de base de données qui est utilisé pour la création d'une connexion de base de données.

DSProxyHost

Spécifie le nom d'hôte du serveur proxy utilisé pour la connexion au serveur DataSnap.

DSProxyPassword

Spécifie le mot de passe de DSProxyUsername.

DSProxyPort

Spécifie le port du serveur proxy utilisé pour la connexion au serveur DataSnap.

DSProxyUsername

Spécifie le nom d'utilisateur reconnu par le serveur proxy utilisé pour la connexion au serveur DataSnap.

ErrorResourceFile

Utilisé seulement par les versions Linux de dbExpress pour spécifier un fichier de messages d'erreur localisé.

Filters

Spécifie la configuration de filtrage.

La configuration de filtrage est spécifiée sous la forme d'une chaîne contenant des données au format JSON. La configuration de filtrage doit être un objet JSON avec des paires clé-valeur qui indiquent les filtres utilisés et leur configuration.

L'objet JSON suivant montre comment utiliser l'ensemble des filtres pris en charge et spécifier leurs propriétés de configuration :

{
    "PC1": {
        "Key": "<PC1 key>"
    },
    "RSA": {
        "KeyExponent": "<key exponent>",
        "KeyLength": "<key length>",
        "UseGlobalKey": "<false or true>"
    },
    "ZLibCompression": {
    }
}

Par exemple, pour configurer le filtre de compression ZLib, utilisez la valeur suivante :

{ "ZLibCompression": {} }

GetDriverFunc

Utilisée par les pilotes DBXDynalink pour spécifier le point d'entrée exporté pour le chargement d'un pilote avant dbExpress 4.

HostName

Nom hôte d'un serveur de base de données auquel se connecte un pilote.

InstalledDrivers

La section de dbxdrivers.ini qui spécifie quels sont les pilotes activés.

IPImplementationID

ID de l'implémentation IP.

IsolationLevel

Isolation de transaction initiale à utiliser lors de la connexion à une base de données. L'isolation de transaction peut également être spécifiée lorsqu'une transaction est démarrée.

LibraryName

Utilisée par les pilotes DBXDynalink pour spécifier le nom de la DLL DBXDynalink.

LibraryNameOsx

Utilisée par les pilotes DBXDynalink pour spécifier le nom de la dylib DBXDynalink pour OS X.

MaxBlobSize

Taille BLOB maximale. Définie sur –1 pour spécifier l'absence de limite.

MetaDataAssemblyLoader

La classe du chargeur de la métadonnée gérée utilisée pour charger dynamiquement un pilote géré à partir d'un assemblage.

MetaDataPackageLoader

La classe du chargeur de la métadonnée native utilisée pour charger dynamiquement un pilote natif à partir d'un package.

Password

Mot de passe de connexion utilisé pour la connexion à une base de données.

Port

Numéro de port d'un serveur de base de données auquel se connecte un pilote.

ProductName

Fournit le nom de produit de la métadonnée dbExpress.

ProductVersion

Peut être spécifiée comme une propriété de pilote en tant que redéfinition de la propriété TDBXConnection.ProductVersion. Cela peut être nécessaire pour les pilotes n'ayant pas la possibilité de signaler la version du produit. La constante ProductVersion est un numéro au format nn.nn.nnnn.

Role

Rôle de connexion utilisé pour la connexion à une base de données.

RowSetSize

Taille de l'ensemble de lignes.

SchemaOverride

La plupart des applications n'ont pas l'utilité de cette constante. Elle est fournie pour assurer une compatibilité descendante de la VCL dbExpress. Les composants VCL utilisent ce paramètre pour définir la portée des requêtes des métadonnées. Cette propriété doit être définie sur user-name.override-schema-name. Par exemple, les tables créées par l'utilisateur MSSQL sa sont placées dans le schéma dbo. Dans ce cas, SchemaOverride peut être défini sur 'sa.dbo'. En conséquence, la VCL spécifie le schéma 'dbo' pour les requêtes des métadonnées lorsqu'une connexion est établie avec l'utilisateur 'sa'. Un modèle SQL du genre '%' peut également être utilisé pour le nom de l'utilisateur (user-name) et le nom du schéma redéfini (override-schema-name). Par exemple, '%.%' provoque la non spécification du schéma pour tous les utilisateurs.

ServerConnection

Lors de la connexion à un serveur DataSnap, c'est le nom d'une méthode serveur qui renvoie une instance d'un TDBXConnection. Toutes les instructions SQL et les commandes de procédures stockées SQL sont exécutées sur cette instance de TDBXConnection. Cela permet aux méthodes client et serveur de partager la même connexion de base de données. Il existe une méthode DSAdmin.GetConnection intégrée qui prend un seul paramètre d'entrée (le nom d'une connexion dans le fichier dbxconnections.ini côté serveur) et renvoie une instance TDBXConnection. Par exemple, pour définir le ServerConnection en utilisant cette méthode serveur pour une connexion appelée "myoracleconnection", définissez ServerConnection : {{{1}}}. Vous pouvez également implémenter votre propre méthode serveur qui renvoie une instance de TDBXConnection.

SupportsParameterMetadata

Cette constante peut être transmise à la méthode TDBXConnection.GetVendorProperty pour déterminer si le pilote prend en charge les métadonnées de paramètre. Si les métadonnées de paramètre sont prises en charge, l'exécution de la méthode TDBXCommand.Prepare provoque le remplissage automatique de la liste de paramètres TDBXCommand par les paramètres de la commande. Notez que si des paramètres étaient déjà ajoutés à la commande, les paramètres ne sont pas ajoutés automatiquement.

URLPath

Spécifie le chemin de l'application Web du serveur DataSnap. Par exemple, vous pouvez utiliser URLPath pour spécifier le répertoire virtuel d'une DLL ISAPI du serveur DataSnap.

UserName

Nom utilisateur de connexion utilisé pour la connexion à une base de données.

VendorLib

Utilisée par les pilotes DBXDynalink. Nom d'une bibliothèque client spécifique au fournisseur.

VendorLibOsx

Utilisée par les pilotes DBXDynalink. Nom d'une bibliothèque client spécifique au fournisseur pour OS X.

VendorLibWin64

Utilisée par les pilotes DBXDynalink. Nom d'une bibliothèque client spécifique au fournisseur pour Windows 64 bits.

Voir aussi