Stellt die Datenbank-Verbindungszeichenfolge bereit.
Visual Basic Public Overrides Property ConnectionString As String
C# public override string ConnectionString { get; set; }
Die ConnectionString-Eigenschaft ist so ausgelegt, dass sie so eng wie möglich an das Format der SQL Anywhere-Verbindungszeichenfolge angepasst ist, wobei aber folgende Ausnahme gilt: Wenn der Persist Security Info-Wert auf FALSE gesetzt ist (Standardwert), entspricht die zurückgegebene Verbindungszeichenfolge der vom Benutzer definierten ConnectionString-Eigenschaft abzüglich der Sicherheitsinformationen. Der SQL Anywhere .NET-Datenprovider speichert das Kennwort nur dann dauerhaft in einer zurückgegebenen Verbindungszeichenfolge, wenn Persist Security Info auf TRUE gesetzt ist.
Sie können die ConnectionString-Eigenschaft verwenden, um eine Verbindung mit einer Reihe von Datenquellen herzustellen.
Sie können die ConnectionString-Eigenschaft nur dann definieren, wenn die Verbindung geschlossen ist. Viele Werte für die Verbindungszeichenfolge haben zugehörige schreibgeschützte Eigenschaften. Wenn die Verbindungszeichenfolge definiert ist, werden alle diese Eigenschaften aktualisiert, sofern nicht ein Fehler erkannt wird. Falls ein Fehler festgestellt wird, wird keine der Eigenschaften aktualisiert. SAConnection-Eigenschaften geben nur die Einstellungen zurück, die im ConnectionString-Objekt enthalten sind.
Wenn Sie ConnectionString bei einer geschlossenen Verbindung zurücksetzen, werden alle Werte für die Verbindungszeichenfolge und die dazugehörigen Eigenschaften zurückgesetzt, einschließlich des Kennworts.
Wenn die Eigenschaft gesetzt wird, wird eine vorbereitende Validierung der Verbindungszeichenfolge durchgeführt. Wenn eine Anwendung die Open-Methode aufruft, wird die Verbindungszeichenfolge vollständig validiert. Eine Laufzeit-Ausnahmebedingung wird generiert, wenn die Verbindungszeichenfolge ungültige oder nicht unterstützte Eigenschaften enthält.
Werte können in Apostrophe oder Anführungszeichen gesetzt werden. Apostrophe oder Anführungszeichen können innerhalb einer Verbindungszeichenfolge benutzt werden, in der das jeweils andere Begrenzungszeichen benutzt wird, z.B. name="Wert'berichtigung" oder name= 'Wert"berichtigung', aber nicht name='Wert'berichtigung' oder name= ""Wertberichtigung"". Leerzeichen werden ignoriert, außer wenn sie innerhalb eines Werts oder zwischen Anführungszeichen bzw. Apostrophen gestellt werden. Schlüsselwert=Wert-Paare müssen durch Semikolon getrennt werden. Wenn ein Semikolon Teil eines Werts ist, muss es ebenfalls durch Anführungszeichen begrenzt werden. Escape-Sequenzen werden nicht unterstützt und der Werttyp ist nicht relevant. Bei Namen wird die Groß- und Kleinschreibung nicht berücksichtigt. Wenn ein Eigenschaftsname mehr als einmal in der Verbindungszeichenfolge vorkommt, wird der Wert verwendet, der mit dem zuletzt angegebenen Eigenschaftsnamen verbunden ist.
Beachten Sie gewisse Vorsichtsmaßnahmen, wenn Sie eine Verbindungszeichenfolge erstellen, die auf Benutzereingaben beruht, etwa wenn eine Benutzer-ID und ein Kennwort aus einem Fenster abgerufen und an die Verbindungszeichenfolge angehängt wird. Die Anwendung darf nicht zulassen, dass ein Benutzer zusätzliche Parameter für die Verbindungszeichenfolge in diese Werte einbettet.
Der Standardwert für die Verbindungspoolfunktion ist TRUE (pooling=TRUE).
Die folgende Anweisung definiert eine Verbindungszeichenfolge für eine ODBC-Datenquelle namens "SQL Anywhere 11 Demo" und öffnet die Verbindung.
SAConnection conn = new SAConnection(); conn.ConnectionString = "DSN=SQL Anywhere 11 Demo"; conn.Open(); |
| Kommentieren Sie diese Seite in DocCommentXchange. Senden Sie uns Feedback über diese Seite via E-Mail. |
Copyright © 2009, iAnywhere Solutions, Inc. - SQL Anywhere 11.0.1 |