Data.DBXCommon.TDBXPropertyNames

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

System.TObjectTDBXPropertyNames

Delphi

TDBXPropertyNames = class

C++

class PASCALIMPLEMENTATION TDBXPropertyNames : public System::TObject

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
class public
Data.DBXCommon.pas
Data.DBXCommon.hpp
Data.DBXCommon Data.DBXCommon


Beschreibung

Eigenschaftsnamen werden für Verbindungen und Treiber zum Bereitstellen von Informationen, wie z. B. Benutzernamen und Passwörter, verwendet.

In der folgenden Tabelle sind die vorhandenen Eigenschaftsnamen aufgeführt:

Konstante Beschreibung

AutoUnloadDriver

Bei True entladen dynamische gelinkte Treibe automatisch ihre DLL, wenn keine Verbindungen mehr vorhanden sind, die den Treiber verwenden.

BufferKBSize

Für Lese- und Schreibvorgänge von Client-Treibertransporten zu verwendende Puffergröße in Kilobyte. Wird gegenwärtig von Data.DBXClient verwendet.

CommunicationIPVersion

Legt die IP-Version für die Kommunikation fest.

CommunicationProtocol

Legt das Kommunikationsprotokoll fest.

CommunicationTimeout

Legt die Zeit fest, die maximal auf den Austausch eines Datenpakets gewartet werden soll. Beim Überschreiten der Zeitspanne wird eine Exception ausgelöst. Dieser Vorgang wird nicht von allen Treibern unterstützt.

ConnectionName

Name der Verbindung. Wenn Verbindungseigenschaften aus der Datei dbxconnections.ini gelesen werden, ist dies der Abschnittsname in der .ini-Datei. Ein AdoDbx-Client kann diese Eigenschaftseinstellung für einen einfachen Verbindungs-String verwenden. Mit Verbindungsnamen kann auch eine Verbindung aus einer TDBXConnectionFactory-Instanz geladen werden.

ConnectionString

String, der die erforderlichen Informationen zum Einrichten der Verbindung bereitstellt.

ConnectTimeout

Maximale Zeitspanne in Sekunden, die auf das Öffnen einer neuen Verbindung gewartet wird. Beim Überschreiten der Zeitspanne wird eine Exception ausgelöst. Dieser Vorgang wird nicht von allen Treibern unterstützt.

Database

Name einer Datenbank, zu der eine Verbindung hergestellt werden soll.

DatasnapContext

Legt einen Schlüssel für einen URL-Pfad zum DataSnap-HTTP-Dienst fest.

DBHostName

Hostname des Computers, auf dem sich die Datenbank befindet.

DelegateConnection

Delegatverbindung, die von dieser Verbindung verwendet wird. Delegatverbindungen implementieren das dbExpress 4 Treiber-Framework. Sie können vor der Delegierung an die tatsächliche Verbindung oder eine andere Delegatverbindung Vor- oder Nachverarbeitungen aller public und protected Methoden ausführen.

DelegateDriver

Legt fest, dass dieser Treiber ein Delegat ist und nur in Verbindung mit einem Nicht-Delegattreiber verwendet werden kann.

DisplayDriverName

Anzeigename des Treibers.

DriverAssembly
(veraltet)

Wird zum dynamischen Laden eines verwalteten Treibers verwendet.

Hinweis: Sie können an das Ende der Eigenschaftseinstellung DriverPackageLoader ein Komma und den Package-Namen anfügen, anstatt DriverAssembly zu verwenden.

DriverAssemblyLoader

Klasse zum Laden eines verwalteten Treibers. Wird zum dynamischen Laden eines verwalteten Treibers aus einer Assembly verwendet. Durch Komma getrennter Klassen- und Package-Name.

DriverName

Eindeutiger Name eines dbExpress-Treibers. Wird von der Datei dbxconnections.ini zum Verweisen auf einen Verbindungstreiber in der Datei dbxdrivers.ini verwendet.

DriverPackage
(veraltet)

Wird zum dynamischen Laden eines nativen Treibers verwendet.

Hinweis: Sie können an das Ende der Eigenschaftseinstellung DriverPackageLoader ein Komma und den Package-Namen anfügen, anstatt DriverPackage zu verwenden.

DriverPackageLoader

Klasse zum Laden eines nativen Treibers. Wird zum dynamischen Laden eines nativen Treibers aus einem Package verwendet. Durch Komma getrennter Klassen- und Package-Name.

DriverUnit

Wird zum Bereitstellen einer informativen Fehlermeldung verwendet, wenn der Treiber nicht geladen werden kann.

DSAuthenticationPassword

Legt ein Passwort fest, mit dem sich ein DataSnap-Benutzer beim Server authentifizieren muss.

DSAuthenticationScheme

Legt das URL-Schema zur Authentifizierung beim Verbinden mit dem DataSnap-Server fest.

DSAuthenticationUser

Legt den Benutzernamen fest, der vom DataSnap-Server erkannt wird. Hierbei handelt es sich um ein anderes Konzept als die Verwendung eines Datenbankbenutzers zum Erstellen einer Datenbankverbindung.

DSProxyHost

Legt den Hostnamen des Proxy-Servers fest, der für die Verbindung mit dem DataSnap-Server verwendet wird.

DSProxyPassword

Legt das Passwort von DSProxyUsername fest.

DSProxyPort

Legt den Port des Proxy-Servers fest, der für die Verbindung mit dem DataSnap-Server verwendet wird.

DSProxyUsername

Legt den Benutzernamen fest, der vom Proxy-Server für die Verbindung mit dem DataSnap-Server verwendet wird.

ErrorResourceFile

Nur für den internen Gebrauch.

Filters

Legt die Filterkonfiguration fest.

Die Filterkonfiguration wird als String mit Daten im JSON-Format angegeben. Die Filterkonfiguration muss ein JSON-Objekt mit Schlüssel/Wertepaaren sein, die die verwendeten Filter und deren Konfiguration angeben.

Das folgende JSON-Objekt zeigt, wie alle unterstützten Filter verwendet und alle Konfigurationseigenschaften festgelegt werden:

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

Verwenden Sie zum Konfigurieren des ZLib-Komprimierungsfilters beispielsweise den folgenden Wert:

{ "ZLibCompression": {} }

GetDriverFunc

Wird von DBXDynalink-Treibern beim Laden eines Treibers in Versionen vor dbExpress 4 zum Festlegen des exportierten Eintrittspunkts verwendet.

HostName

Hostname eines Datenbankservers, zu dem ein Treiber eine Verbindung herstellt.

InstalledDrivers

Abschnitt in der Datei dbxdrivers.ini, der festlegt, welche Treiber aktiviert sind.

IPImplementationID

ID der IP-Implementierung.

IsolationLevel

Anfangstransaktionsisolation, die für die Datenbankverbindung verwendet wird. Die Transaktionsisolation kann auch festgelegt werden, wenn eine Transaktion begonnen wird.

LibraryName

Wird von DBXDynalink-Treibern zum Festlegen des Namens der DBXDynalink-DLL verwendet.

LibraryNameOsx

Wird von DBXDynalink-Treibern zum Festlegen des Namens der DBXDynalink-DYLIB für OS X verwendet.

MaxBlobSize

Maximale BLOB-Größe. Die Einstellung –1 bedeutet keine Größenbeschränkung.

MetaDataAssemblyLoader

Klasse zum Laden von verwalteten Metadaten. Wird zum dynamischen Laden eines verwalteten Treibers aus einer Assembly verwendet.

MetaDataPackageLoader

Klasse zum Laden von nativen Metadaten. Wird zum dynamischen Laden eines nativen Treibers aus einem Package verwendet.

Password

Name des Anmeldepassworts, das für die Datenbankverbindung verwendet wird.

Port

Portnummer eines Datenbankservers, zu dem ein Treiber eine Verbindung herstellt.

ProductName

Stellt den Produktnamen für die dbExpress-Metadaten bereit.

ProductVersion

Kann als Treibereigenschaft zum Überschreiben der Eigenschaft TDBXConnection.ProductVersion festgelegt werden. Dies kann für Treiber erforderlich sein, die über die Produktversion keine Auskunft geben können. Die Produktversion ist eine Zahl im Format nn.nn.nnnn.

Role

Anmelderolle, die für die Datenbankverbindung verwendet wird.

RowSetSize

Größe des Rowsets.

SchemaOverride

Eine direkte Verwendung dieser Konstante ist normalerweise nicht erforderlich. Sie ist nur aus Gründen der Abwärtskompatibilität mit der dbExpress-VCL vorhanden. VCL-Komponenten verwenden diese Einstellung bei Metadatenanforderungen. Diese Eigenschaft sollte auf user-name.override-schema-name gesetzt werden. Zum Beispiel werden Tabellen, die vom MSSQL-Systemadministrator (sa) erstellt wurden, in das dbo-Schema platziert. In diesem Fall kann SchemaOverride auf "sa.dbo" gesetzt werden. Dadurch wird die VCL veranlasst, beim Herstellen einer Verbindung mit dem Benutzer "sa" das Schema "dbo" für Metadatenanforderungen festzulegen. Es kann auch ein SQL-Muster wie '%' für "user-name" und "override-schema-name" verwendet werden. '%.%' bewirkt beispielsweise, dass das Schema nicht für alle Benutzer festgelegt wird.

ServerConnection

Bei der Verbindung zu einem DataSnap-Server ist das der Name einer Servermethode, die eine Instanz von TDBXConnection zurückgibt. Alle SQL-Anweisungen und SQL-Befehle für gespeicherte Prozeduren werden für diese TDBXConnection-Instanz ausgeführt. Dadurch können Client- und Servermethoden dieselbe Datenbankverbindung nutzen. Es gibt eine integrierte DSAdmin.GetConnection-Methode, die den Namen einer Verbindung in der serverseitigen dbxconnections.ini-Datei als einzelnen Eingabeparameter übernimmt, und eine TDBXConnection-Instanz zurückgibt. Um beispielsweise die ServerConnection mit dieser Servermethode für eine Verbindung mit dem Namen "myoracleconnection" festzulegen, geben Sie für ServerConnection Folgendes an: {{{1}}}. Alternativ können Sie auch eine eigene Servermethode implementieren, die eine TDBXConnection-Instanz zurückgibt.

SupportsParameterMetadata

Diese Eigenschaft kann an die Methode TDBXConnection.GetVendorProperty übergeben werden, um festzustellen, ob der Treiber Parametermetadaten unterstützt. Wenn Parametermetadaten unterstützt werden, wird bei Ausführung der Methode TDBXCommand.Prepare die TDBXCommand-Parameterliste automatisch mit Parametern für den Befehl gefüllt. Beachten Sie bitte, dass dem Befehl nicht automatisch Parameter hinzugefügt werden, wenn bereits welche hinzugefügt wurden.

URLPath

Legt den Pfad zu einer DataSnap-Server-Webanwendung fest. Mit URLPath können Sie beispielsweise das virtuelle Verzeichnis einer ISAPI-DLL des DataSnap-Servers angeben.

UserName

Anmeldename des Benutzers, der für die Datenbankverbindung verwendet wird.

VendorLib

Wird von DBXDynalink-Treibern verwendet. Name einer herstellerspezifischen Clientbibliothek.

VendorLibOsx

Wird von DBXDynalink-Treibern verwendet. Name einer herstellerspezifischen Clientbibliothek für OS X.

VendorLibWin64

Wird von DBXDynalink-Treibern verwendet. Name einer herstellerspezifischen Clientbibliothek für 64-Bit-Windows.

Siehe auch