OracleConnectionStringBuilder Klasse

Definition

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Achtung

OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

Bietet eine einfache Möglichkeit zum Erstellen und Verwalten des Inhalts von Verbindungszeichenfolgen, die von der OracleConnection Klasse verwendet werden.

public ref class OracleConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder

[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))]
[System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))>]
[<System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleConnectionStringBuilder = class
    inherit DbConnectionStringBuilder

Public NotInheritable Class OracleConnectionStringBuilder
Inherits DbConnectionStringBuilder

Vererbung

Object

DbConnectionStringBuilder

OracleConnectionStringBuilder

Attribute

TypeConverterAttribute ObsoleteAttribute

Hinweise

Dieser Typ ist veraltet und wird in einer zukünftigen Version von .NET Framework entfernt. Weitere Informationen finden Sie unter Oracle und ADO.NET.

Mit den Verbindungszeichenfolgen-Generatoren können Entwickler syntaktisch korrekte Verbindungszeichenfolgen programmgesteuert erstellen und vorhandene Verbindungszeichenfolgen mithilfe von Eigenschaften und Methoden der Klasse analysieren und neu erstellen. Der Verbindungszeichenfolgen-Generator stellt stark typierte Eigenschaften bereit, die den bekannten Schlüssel-Wert-Paaren entsprechen, die von Oracle zulässig sind. Die OracleConnectionStringBuilder Klasse implementiert die ICustomTypeDescriptor Schnittstelle. Dies bedeutet, dass die Klasse zur Entwurfszeit mit Visual Studio .NET-Designern arbeitet. Wenn Entwickler den Designer verwenden, um stark typierte DataSets und stark typierte Verbindungen in Visual Studio .NET zu erstellen, zeigt die stark typierte Verbindungszeichenfolgen-Generator-Klasse die Eigenschaften an, die ihrem Typ zugeordnet sind, und verfügt außerdem über Konverter, die allgemeine Werte für bekannte Schlüssel zuordnen können.

Entwickler, die als Teil von Anwendungen Verbindungszeichenfolgen erstellen müssen, können die OracleConnectionStringBuilder-Klasse verwenden, um Verbindungszeichenfolgen zu erstellen und zu ändern. Die OracleConnectionStringBuilder Klasse erleichtert auch die Verwaltung von Verbindungszeichenfolgen, die in einer Anwendungskonfigurationsdatei gespeichert sind.

Die OracleConnectionStringBuilder führt Überprüfungen auf gültige Schlüssel-Wert-Paare aus. Daher kann diese Klasse nicht zum Erstellen ungültiger Verbindungszeichenfolgen verwendet werden. Wenn Sie versuchen, ungültige Paare hinzuzufügen, wird eine Ausnahme ausgelöst. Die OracleConnectionStringBuilder-Klasse verwaltet eine feste Sammlung von Synonymen und kann bei Bedarf die erforderliche Übersetzung ausführen, um von einem Synonym in den entsprechenden bekannten Schlüsselnamen zu konvertieren. Wenn Sie beispielsweise die eigenschaft Item[] verwenden, um einen Wert abzurufen, können Sie eine Zeichenfolge angeben, die ein beliebiges Synonym für den benötigten Schlüssel enthält. Eine vollständige Liste zulässiger Synonyme finden Sie in der Item[]-Eigenschaft.

Die OracleConnectionStringBuilder behandelt Versuche, bösartige Einträge einzufügen. Der folgende Code wird z. B. mit der Standardeigenschaft Item[] (indexer in C#) dem geschachtelten Schlüssel-Wert-Paar ordnungsgemäß escapet.

Dim builder As New System.Data. _
    OracleClient.OracleConnectionStringBuilder
builder("Data Source") = "OracleDemo;NewValue=Bad"
builder("Integrated Security") = True
builder("User ID") = "Mary;NewValue=Bad"
System.Diagnostics.Debug.WriteLine(builder.ConnectionString)

System.Data.OracleClient.OracleConnectionStringBuilder builder =
   new System.Data.OracleClient.OracleConnectionStringBuilder();
builder["Data Source"] = "OracleDemo";
builder["integrated Security"] = true;
builder["User ID"] = "Mary;NewValue=Bad";
System.Diagnostics.Debug.WriteLine(builder.ConnectionString);

Das Ergebnis ist die folgende Verbindungszeichenfolge, die den ungültigen Wert auf sichere Weise behandelt, indem der Wert der Benutzer-ID in Anführungszeichen eingeschlossen wird:

Data Source=OracleDemo;Integrated Security=True;User ID="Mary;NewValue=Bad"

Warnung

Microsoft empfiehlt nicht, Ihren Benutzernamen und Ihr Kennwort direkt anzugeben, da es sich um ein unsicheres Muster handelt. Verwenden Sie nach Möglichkeit sicherere Authentifizierungsflüsse, z. B. verwaltete Identitäten für Azure-Ressourcen, oder Windows-Authentifizierungs- für SQL Server.

Konstruktoren

OracleConnectionStringBuilder()	Veraltet. Initialisiert eine neue Instanz der OracleConnectionStringBuilder Klasse.
OracleConnectionStringBuilder(String)	Veraltet. Initialisiert eine neue Instanz der OracleConnectionStringBuilder Klasse. Die bereitgestellte Verbindungszeichenfolge stellt die Daten für die internen Verbindungsinformationen der Instanz bereit.

Eigenschaften

BrowsableConnectionString	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die ConnectionString -Eigenschaft in Visual Studio-Designern sichtbar ist. (Geerbt von DbConnectionStringBuilder)
ConnectionString	Veraltet. Dient zum Abrufen oder Festlegen der Verbindungszeichenfolge, die dem DbConnectionStringBuilderzugeordnet ist. (Geerbt von DbConnectionStringBuilder)
Count	Veraltet. Ruft die aktuelle Anzahl der Schlüssel ab, die in der eigenschaft ConnectionString enthalten sind. (Geerbt von DbConnectionStringBuilder)
DataSource	Veraltet. Ruft den Namen der Oracle-Datenquelle ab, mit der eine Verbindung hergestellt werden soll, oder legt diesen fest.
Enlist	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Pooler die Verbindung automatisch im aktuellen Transaktionskontext des Erstellungsthreads auflistet.
IntegratedSecurity	Veraltet. Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob "Benutzer-ID" und "Kennwort" in der Verbindung angegeben werden (wenn false) oder ob die aktuellen Windows-Kontoanmeldeinformationen für die Authentifizierung verwendet werden (wenn true).
IsFixedSize	Veraltet. Ruft einen Wert ab, der angibt, ob die OracleConnectionStringBuilder eine feste Größe aufweist.
IsReadOnly	Veraltet. Ruft einen Wert ab, der angibt, ob die DbConnectionStringBuilder schreibgeschützt ist. (Geerbt von DbConnectionStringBuilder)
Item[String]	Veraltet. Dient zum Abrufen oder Festlegen des Werts, der dem angegebenen Schlüssel zugeordnet ist. In C# ist diese Eigenschaft der Indexer.
Keys	Veraltet. Ruft eine ICollection ab, die die Schlüssel in der OracleConnectionStringBuilderenthält.
LoadBalanceTimeout	Veraltet. Ruft die Mindestzeit in Sekunden ab, damit die Verbindung im Verbindungspool aktiv ist, bevor sie entfernt wird, oder legt diese fest.
MaxPoolSize	Veraltet. Dient zum Abrufen oder Festlegen der maximalen Anzahl von Verbindungen, die im Verbindungspool für diese bestimmte Verbindungszeichenfolge zulässig sind.
MinPoolSize	Veraltet. Ruft die mindestanzahl der im Verbindungspool zulässigen Verbindungen für diese bestimmte Verbindungszeichenfolge ab, oder legt diese fest.
OmitOracleConnectionName	Veraltet. Dient zum Abrufen oder Festlegen des Flags, das Transaktionsrollbacks in früheren Versionen von Oracle (vor 8.1.7.4.1) ermöglicht.
Password	Veraltet. Ruft das Kennwort für das Oracle-Konto ab oder legt es fest.
PersistSecurityInfo	Veraltet. Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob sicherheitsrelevante Informationen, z. B. das Kennwort, nicht als Teil der Verbindung zurückgegeben werden, wenn die Verbindung geöffnet ist oder sich jemals in einem geöffneten Zustand befindet.
Pooling	Veraltet. Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob die Verbindung in einem Pool zusammengefasst wird oder ob jede Verbindung jedes Mal explizit geöffnet wird, wenn die Verbindung angefordert wird.
Unicode	Veraltet. Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob der Client die Unicode-Funktionalität unterstützt, die in späteren Oracle-Clients verfügbar ist oder wenn er nicht Unicode-fähig ist.
UserID	Veraltet. Ruft die Benutzer-ID ab, die beim Herstellen einer Verbindung mit Oracle verwendet werden soll, oder legt diese fest.
Values	Veraltet. Ruft eine ICollection ab, die die Werte in der OracleConnectionStringBuilderenthält.

Methoden

Add(String, Object)	Veraltet. Fügt dem DbConnectionStringBuildereinen Eintrag mit dem angegebenen Schlüssel und Wert hinzu. (Geerbt von DbConnectionStringBuilder)
Clear()	Veraltet. Löscht den Inhalt der OracleConnectionStringBuilder Instanz.
ClearPropertyDescriptors()	Veraltet. Löscht die Auflistung von PropertyDescriptor -Objekten für die zugeordnete DbConnectionStringBuilder. (Geerbt von DbConnectionStringBuilder)
ContainsKey(String)	Veraltet. Bestimmt, ob die OracleConnectionStringBuilder einen bestimmten Schlüssel enthält.
Equals(Object)	Veraltet. Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
EquivalentTo(DbConnectionStringBuilder)	Veraltet. Vergleicht die Verbindungsinformationen in diesem DbConnectionStringBuilder -Objekt mit den Verbindungsinformationen im angegebenen Objekt. (Geerbt von DbConnectionStringBuilder)
GetHashCode()	Veraltet. Dient als Standardhashfunktion. (Geerbt von Object)
GetProperties(Hashtable)	Veraltet. Füllt eine bereitgestellte Hashtable mit Informationen zu allen Eigenschaften dieses DbConnectionStringBuilder. (Geerbt von DbConnectionStringBuilder)
GetType()	Veraltet. Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Veraltet. Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
Remove(String)	Veraltet. Entfernt den Eintrag mit dem angegebenen Schlüssel aus der OracleConnectionStringBuilder Instanz.
ShouldSerialize(String)	Veraltet. Gibt an, ob der angegebene Schlüssel in dieser OracleConnectionStringBuilder Instanz vorhanden ist.
ToString()	Veraltet. Gibt die dieser DbConnectionStringBuilderzugeordnete Verbindungszeichenfolge zurück. (Geerbt von DbConnectionStringBuilder)
TryGetValue(String, Object)	Veraltet. Ruft einen Wert ab, der dem bereitgestellten Schlüssel aus diesem OracleConnectionStringBuilderentspricht.

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32)	Veraltet. Kopiert die Elemente des ICollection in einen Array, beginnend bei einem bestimmten Array Index. (Geerbt von DbConnectionStringBuilder)
ICollection.IsSynchronized	Veraltet. Ruft einen Wert ab, der angibt, ob der Zugriff auf die ICollection synchronisiert wird (Threadsicher). (Geerbt von DbConnectionStringBuilder)
ICollection.SyncRoot	Veraltet. Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf die ICollectionverwendet werden kann. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Veraltet. Gibt eine Auflistung von benutzerdefinierten Attributen für diese Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Veraltet. Gibt den Klassennamen dieser Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Veraltet. Gibt den Namen dieser Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Veraltet. Gibt einen Typkonverter für diese Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Veraltet. Gibt das Standardereignis für diese Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Veraltet. Gibt die Standardeigenschaft für diese Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Veraltet. Gibt einen Editor des angegebenen Typs für diese Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Veraltet. Gibt die Ereignisse für diese Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Veraltet. Gibt die Ereignisse für diese Instanz einer Komponente zurück, die das angegebene Attributarray als Filter verwendet. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Veraltet. Gibt die Eigenschaften für diese Instanz einer Komponente zurück. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Veraltet. Gibt die Eigenschaften für diese Instanz einer Komponente zurück, die das Attributarray als Filter verwendet. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Veraltet. Gibt ein Objekt zurück, das die durch den angegebenen Eigenschaftsdeskriptor beschriebene Eigenschaft enthält. (Geerbt von DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Veraltet. Fügt dem IDictionary-Objekt ein Element mit dem bereitgestellten Schlüssel und Wert hinzu. (Geerbt von DbConnectionStringBuilder)
IDictionary.Contains(Object)	Veraltet. Bestimmt, ob das IDictionary -Objekt ein Element mit dem angegebenen Schlüssel enthält. (Geerbt von DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Veraltet. Gibt ein IDictionaryEnumerator -Objekt für das IDictionary -Objekt zurück. (Geerbt von DbConnectionStringBuilder)
IDictionary.Item[Object]	Veraltet. Ruft das Element mit dem angegebenen Schlüssel ab oder legt es fest. (Geerbt von DbConnectionStringBuilder)
IDictionary.Remove(Object)	Veraltet. Entfernt das Element mit dem angegebenen Schlüssel aus dem IDictionary -Objekt. (Geerbt von DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Veraltet. Gibt einen Enumerator zurück, der eine Auflistung durchläuft. (Geerbt von DbConnectionStringBuilder)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Veraltet. Wandelt die Elemente eines IEnumerable in den angegebenen Typ um.
OfType<TResult>(IEnumerable)	Veraltet. Filtert die Elemente einer IEnumerable basierend auf einem angegebenen Typ.
AsParallel(IEnumerable)	Veraltet. Aktiviert die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Veraltet. Wandelt eine IEnumerable in eine IQueryableum.

Weitere Informationen

• Erstellen von Verbindungszeichenfolgen