OracleConnectionStringBuilder Klasse

Referenz

Definition

Namespace:: System.Data.OracleClient

Assembly:: System.Data.OracleClient.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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))]
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)]
public sealed class OracleConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))>]
type OracleConnectionStringBuilder = class
    inherit 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 der Verbindungszeichenfolge und übergibt dann die ConnectionString Eigenschaft der OracleConnectionStringBuilder Instanz an den Konstruktor der Verbindungsklasse. Im Beispiel wird auch eine vorhandene Verbindungszeichenfolge analysiert und verschiedene Möglichkeiten zum Bearbeiten des Inhalts der Verbindungszeichenfolge veranschaulicht.

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 der .NET Framework entfernt. Weitere Informationen finden Sie unter Oracle und ADO.NET.

Mit den Verbindungszeichenfolgen-Generatoren können Entwickler syntisch korrekte Verbindungszeichenfolgen programmgesteuert erstellen und vorhandene Verbindungszeichenfolgen mithilfe von Eigenschaften und Methoden der Klasse analysieren und neu erstellen. Der Verbindungszeichenfolgen-Generator bietet stark eingegebene Eigenschaften, 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 mit Visual Studio .NET-Designern zur Entwurfszeit funktioniert. Wenn Entwickler den Designer verwenden, um stark eingegebene DataSets und stark eingegebene Verbindungen innerhalb Visual Studio .NET zu erstellen, zeigt die stark eingegebene Verbindungszeichenfolgen-Generatorklasse die Eigenschaften an, die dem Typ zugeordnet sind und auch Konverter enthalten, 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 das Verwalten 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. Beim Versuch, 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 ausführen, um von einem Synonym in den entsprechenden bekannten Schlüsselnamen zu konvertieren. Wenn Sie beispielsweise die Eigenschaft zum Abrufen eines Werts verwenden, können Sie eine Zeichenfolge angeben, die Item[] 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 Behandeln behandeln Versuche, böswillige Einträge einzufügen. Im folgenden Code wird beispielsweise mithilfe der Standardeigenschaft Item[] (der Indexer in C#) das geschachtelte Schlüssel-/Wertpaar ordnungsgemäß entschlüsselt.

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 auf sichere Weise behandelt, indem Der Benutzer-ID-Wert in Anführungszeichen eingeschlossen wird:

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

Konstruktoren

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

Eigenschaften

BrowsableConnectionString	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	Ruft die dem DbConnectionStringBuilder zugeordnete Verbindungszeichenfolge ab oder legt sie fest. (Geerbt von DbConnectionStringBuilder)
Count	Ruft die aktuelle Anzahl von Schlüsseln ab, die in der ConnectionString-Eigenschaft enthalten sind. (Geerbt von DbConnectionStringBuilder)
DataSource	Ruft den Namen der Oracle-Datenquelle ab, mit der eine Verbindung hergestellt werden soll, oder legt diesen fest.
Enlist	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	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	Ruft einen Wert ab, der angibt, ob die OracleConnectionStringBuilder eine feste Größe hat.
IsReadOnly	Ruft einen Wert ab, der angibt, ob die DbConnectionStringBuilder schreibgeschützt ist. (Geerbt von DbConnectionStringBuilder)
Item[String]	Ruft den Wert ab, der dem angegebenen Schlüssel zugeordnet ist, oder legt diesen fest. In C# ist diese Eigenschaft der Indexer.
Keys	Ruft eine ICollection ab, die die Schlüssel im OracleConnectionStringBuilder enthält.
LoadBalanceTimeout	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	Ruft die maximale Anzahl von Verbindungen ab, die im Verbindungspool für diese bestimmte Verbindungszeichenfolge zulässig sind, oder legt diese fest.
MinPoolSize	Ruft die minimale Anzahl von Verbindungen ab, die im Verbindungspool für diese bestimmte Verbindungszeichenfolge zulässig sind, oder legt diese fest.
OmitOracleConnectionName	Ruft das Flag ab, das Transaktionsrollbacks auf frühere Versionen von Oracle (vor 8.1.7.4.1) aktiviert, oder legt dieses fest.
Password	Ruft das Kennwort für das Oracle-Konto ab oder legt es fest.
PersistSecurityInfo	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	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	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	Ruft die Benutzer-ID ab, die zum Herstellen einer Oracle-Verbindung verwendet wird, oder legt diese fest.
Values	Ruft ein ICollection ab, das die Werte im OracleConnectionStringBuilder enthält.

Methoden

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

Explizite Schnittstellenimplementierungen

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

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Gilt für:

Siehe auch

Erstellen von Verbindungszeichenfolgen