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, den Inhalt von Verbindungszeichenfolgen, die von der OracleConnection-Klasse verwendet werden, zu erstellen und zu verwalten.

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

Beispiele

Die folgende Konsolenanwendung erstellt Verbindungszeichenfolgen für eine Oracle-Datenbank. Der Code verwendet eine OracleConnectionStringBuilder -Klasse zum Erstellen des Verbindungszeichenfolge und übergibt dann die ConnectionString -Eigenschaft des OracleConnectionStringBuilder instance an den Konstruktor der Verbindungsklasse. Das Beispiel analysiert auch eine vorhandene Verbindungszeichenfolge und veranschaulicht verschiedene Möglichkeiten, den Inhalt des Verbindungszeichenfolge zu bearbeiten.

Hinweis

Das Beispiel umfasst ein Kennwort zur Veranschaulichung der Funktion von OracleConnectionStringBuilder mit Verbindungszeichenfolgen. In den Anwendungen wird die Verwendung der Windows-Authentifizierung empfohlen. Wenn Sie ein Kennwort verwenden müssen, schließen Sie kein hartcodiertes Kennwort in die Anwendung ein.

// You may need to set a reference to the System.Data.OracleClient
// assembly before you can run this sample.
using System.Data.OracleClient;

class Program
{
    static void Main()
    {
        // Create a new OracleConnectionStringBuilder and
        // initialize it with a few name/value pairs.
        OracleConnectionStringBuilder builder =
            new OracleConnectionStringBuilder(GetConnectionString());

        // Note that the input connection string used the
        // Server key, but the new connection string uses
        // the well-known Data Source key instead.
        Console.WriteLine(builder.ConnectionString);

        // Pass the OracleConnectionStringBuilder an existing
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString = "server=OracleDemo;user id=maryc;" +
            "password=pass@word1";

        // Now that the connection string has been parsed,
        // you can work with individual items.
        Console.WriteLine(builder.Password);
        builder.Password = "newPassword";
        builder.PersistSecurityInfo = true;

        // You can refer to connection keys using strings,
        // as well. When you use this technique (the default
        // Item property in Visual Basic, or the indexer in C#),
        // you can specify any synonym for the connection string key
        // name.
        builder["Server"] = ".";
        builder["Load Balance Timeout"] = 1000;
        builder["Integrated Security"] = true;
        Console.WriteLine(builder.ConnectionString);

        Console.WriteLine("Press Enter to finish.");
        Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file.
        return "Server=OracleDemo;Integrated Security=true";
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before running this example.
Imports System.Data.OracleClient

Module Module1
  Sub Main()
    ' Create a new OracleConnectionStringBuilder and
    ' initialize it with a few name/value pairs.
    Dim builder As New OracleConnectionStringBuilder(GetConnectionString())

    ' Note that the input connection string used the 
    ' Server key, but the new connection string uses
    ' the well-known Data Source key instead.
    Console.WriteLine(builder.ConnectionString)

    ' Pass the OracleConnectionStringBuilder an existing 
    ' connection string, and you can retrieve and
    ' modify any of the elements.
    builder.ConnectionString = _
        "server=OracleDemo;user id=Mary;" & _
        "password=*****"
    ' Now that the connection string has been parsed,
    ' you can work with individual items.
    Console.WriteLine(builder.Password)
    builder.Password = "newPassword"
    builder.PersistSecurityInfo = True

    ' You can refer to connection keys using strings, 
    ' as well. When you use this technique (the default
    ' Item property in Visual Basic, or the indexer in C#),
    ' you can specify any synonym for the connection string key
    ' name.
    builder("Server") = "NewDemo"
    builder("Load Balance Timeout") = 1000

    ' The Item property is the default for the class, 
    ' and setting the Item property adds the value to the 
    ' dictionary, if necessary. 
    builder.Item("Integrated Security") = True
    Console.WriteLine(builder.ConnectionString)

    Console.WriteLine("Press Enter to finish.")
    Console.ReadLine()
  End Sub

  Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,
    ' you can retrieve it from a configuration file. 
    Return "Server=OracleDemo;Integrated Security=True;" & _
      "Unicode=True"
  End Function

End Module

Hinweise

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

Die Verbindungszeichenfolge-Generatoren ermöglichen Es Entwicklern, syntaktisch korrekte Verbindungszeichenfolgen programmgesteuert zu erstellen und vorhandene Verbindungszeichenfolgen mithilfe von Eigenschaften und Methoden der -Klasse zu analysieren und neu zu erstellen. Der Verbindungszeichenfolge-Generator stellt stark typisierte 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 funktioniert. Wenn Entwickler den Designer verwenden, um stark typisierte DataSets und stark typisierte Verbindungen in Visual Studio .NET zu erstellen, zeigt die stark typisierte Verbindungszeichenfolge Builder-Klasse die eigenschaften an, die ihrem Typ zugeordnet sind, und verfügt auch über Konverter, die allgemeine Werte für bekannte Schlüssel zuordnen können.

Entwickler, die Verbindungszeichenfolgen als Teil von Anwendungen 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.

Der 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 Auflistung von Synonymen und kann bei Bedarf die erforderliche Übersetzung durchführen, um von einem Synonym in den entsprechenden bekannten Schlüsselnamen zu konvertieren. Wenn Sie beispielsweise die Item[] -Eigenschaft zum Abrufen eines Werts verwenden, können Sie eine Zeichenfolge angeben, die ein beliebiges Synonym für den benötigten Schlüssel enthält. In der Item[]-Eigenschaft finden Sie eine vollständige Liste der akzeptablen Synonyme.

Die OracleConnectionStringBuilder behandelt Versuche, böswillige Einträge einzufügen. Beispielsweise wird das geschachtelte Schlüssel-Wert-Paar mit dem folgenden Code unter Verwendung der Standardeigenschaft Item[] (indexer in C#) ordnungsgemäß mit Escapezeichen versehen.

Dim builder As 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)  

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 sicher behandelt, indem der Wert der Benutzer-ID in Anführungszeichen eingeschlossen wird:

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

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. Ruft einen Wert ab, der angibt, ob die ConnectionString-Eigenschaft in Visual Studio-Designern sichtbar ist, oder legt diesen Wert fest. (Geerbt von DbConnectionStringBuilder)
ConnectionString	Veraltet. Ruft die dem DbConnectionStringBuilder zugeordnete Verbindungszeichenfolge ab oder legt sie fest. (Geerbt von DbConnectionStringBuilder)
Count	Veraltet. Ruft die aktuelle Anzahl von Schlüsseln ab, die in der ConnectionString-Eigenschaft 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. Ruft einen Wert ab oder legt ihn fest, der angibt, ob der Pooler die Verbindung automatisch in den aktuellen Transaktionskontext des Erstellungsthreads einträgt.
IntegratedSecurity	Veraltet. Ruft einen Wert ab oder legt ihn fest, der angibt, ob in der Verbindung "User ID" und "Password" angegeben wurden (dann false), oder ob zur Authentifizierung die aktuellen Anmeldeinformationen des Windows-Kontos verwendet werden (dann true).
IsFixedSize	Veraltet. Ruft einen Wert ab, der angibt, ob die OracleConnectionStringBuilder eine feste Größe hat.
IsReadOnly	Veraltet. Ruft einen Wert ab, der angibt, ob die DbConnectionStringBuilder schreibgeschützt ist. (Geerbt von DbConnectionStringBuilder)
Item[String]	Veraltet. Ruft den Wert ab, der dem angegebenen Schlüssel zugeordnet ist, oder legt diesen fest. In C# ist diese Eigenschaft der Indexer.
Keys	Veraltet. Ruft eine ICollection ab, die die Schlüssel im OracleConnectionStringBuilder enthält.
LoadBalanceTimeout	Veraltet. Ruft die minimale Zeitdauer in Sekunden ab, während der die Verbindung im Verbindungspool verbleiben soll, bis sie entfernt wird, oder legt diese Zeitdauer fest.
MaxPoolSize	Veraltet. Ruft die maximale Anzahl von Verbindungen ab, die im Verbindungspool für diese bestimmte Verbindungszeichenfolge zulässig sind, oder legt diese fest.
MinPoolSize	Veraltet. Ruft die minimale Anzahl von Verbindungen ab, die im Verbindungspool für diese bestimmte Verbindungszeichenfolge zulässig sind, oder legt diese fest.
OmitOracleConnectionName	Veraltet. Ruft das Flag ab, das Transaktionsrollbacks auf frühere Versionen von Oracle (vor 8.1.7.4.1) aktiviert, oder legt dieses fest.
Password	Veraltet. Ruft das Kennwort für das Oracle-Konto ab oder legt es fest.
PersistSecurityInfo	Veraltet. Ruft einen booleschen Wert ab oder legt diesen fest, 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 im geöffneten Zustand befunden hat.
Pooling	Veraltet. Ruft einen booleschen Wert ab oder legt einen fest, der angibt, ob die Verbindung in einem Pool bereitgestellt wird oder jedes Mal, wenn sie angefordert wird, explizit geöffnet wird.
Unicode	Veraltet. Ruft einen booleschen Wert ab, der angibt, ob der Client die für neuere Oracle-Clients verfügbare Unicode-Funktionalität unterstützt, oder legt diesen Wert fest.
UserID	Veraltet. Ruft die Benutzer-ID ab, die zum Herstellen einer Oracle-Verbindung verwendet wird, oder legt diese fest.
Values	Veraltet. Ruft ein ICollection ab, das die Werte im OracleConnectionStringBuilder enthält.

Methoden

Add(String, Object)	Veraltet. Fügt dem DbConnectionStringBuilder einen 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, die dem DbConnectionStringBuilder zugeordnet sind. (Geerbt von DbConnectionStringBuilder)
ContainsKey(String)	Veraltet. Stellt fest, ob der OracleConnectionStringBuilder einen bestimmten Schlüssel enthält.
Equals(Object)	Veraltet. Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
EquivalentTo(DbConnectionStringBuilder)	Veraltet. Vergleicht die Verbindungsinformationen in diesem DbConnectionStringBuilder-Objekt mit den Verbindungsinformationen im angegebenen Objekt. (Geerbt von DbConnectionStringBuilder)
GetHashCode()	Veraltet. Fungiert als Standardhashfunktion. (Geerbt von Object)
GetProperties(Hashtable)	Veraltet. Füllt eine angegebene Hashtable mit Informationen zu allen Eigenschaften dieses DbConnectionStringBuilder. (Geerbt von DbConnectionStringBuilder)
GetType()	Veraltet. Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Veraltet. Erstellt eine flache Kopie des 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 diesem DbConnectionStringBuilder zugeordnete Verbindungszeichenfolge zurück. (Geerbt von DbConnectionStringBuilder)
TryGetValue(String, Object)	Veraltet. Ruft einen Wert ab, der dem von diesem OracleConnectionStringBuilder bereitgestellten Schlüssel entspricht.

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32)	Veraltet. Kopiert die Elemente der ICollection in ein 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 (threadsicher) ist. (Geerbt von DbConnectionStringBuilder)
ICollection.SyncRoot	Veraltet. Ruft ein Objekt ab, mit dem der Zugriff auf ICollection synchronisiert werden kann. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Veraltet. Gibt eine Auflistung benutzerdefinierter Attribute 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, wobei das angegebene Attributarray als Filter verwendet wird. (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, wobei das Attributarray als Filter verwendet wird. (Geerbt von DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Veraltet. Gibt ein Objekt zurück, das die Eigenschaft enthält, die durch den Eigenschaftendeskriptor angegeben ist. (Geerbt von DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Veraltet. Fügt dem IDictionary-Objekt ein Element mit dem angegebenen Schlüssel und Wert hinzu. (Geerbt von DbConnectionStringBuilder)
IDictionary.Contains(Object)	Veraltet. Ermittelt, 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 dieses 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 eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Veraltet. Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Veraltet. Konvertiert einen IEnumerable in einen IQueryable.

Weitere Informationen

• Erstellen von Verbindungszeichenfolgen