OracleConnectionStringBuilder Klasa

Definicja

Przestrzeń nazw:

System.Data.OracleClient

Zestaw:

System.Data.OracleClient.dll

Przestroga

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

Zapewnia prosty sposób tworzenia zawartości parametrów połączenia używanych przez klasę OracleConnection i zarządzania nimi.

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

Dziedziczenie

Object

DbConnectionStringBuilder

OracleConnectionStringBuilder

Atrybuty

TypeConverterAttribute ObsoleteAttribute

Przykłady

Poniższa aplikacja konsolowa tworzy parametry połączenia dla bazy danych Oracle. Kod używa OracleConnectionStringBuilder klasy do utworzenia parametry połączenia, a następnie przekazuje ConnectionString właściwość OracleConnectionStringBuilder wystąpienia do konstruktora klasy połączenia. Przykład analizuje również istniejący parametry połączenia i demonstruje różne sposoby manipulowania zawartością parametry połączenia.

Uwaga

Ten przykład zawiera hasło, które pokazuje, jak OracleConnectionStringBuilder działa z parametrami połączenia. W aplikacjach zalecamy użycie uwierzytelniania systemu Windows. Jeśli musisz użyć hasła, nie dołączaj w aplikacji trwale zakodowanego hasła.

// 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

Uwagi

Ten typ jest przestarzały i zostanie usunięty w przyszłej wersji .NET Framework. Aby uzyskać więcej informacji, zobacz Oracle i ADO.NET.

Konstruktorzy parametry połączenia umożliwiają deweloperom programowe tworzenie składniowo poprawnych parametrów połączenia oraz analizowanie i ponowne kompilowanie istniejących parametrów połączenia przy użyciu właściwości i metod klasy. Konstruktor parametry połączenia udostępnia silnie typizowane właściwości odpowiadające znanym parom klucz/wartość dozwolonym przez firmę Oracle. Klasa OracleConnectionStringBuilder implementuje interfejs ICustomTypeDescriptor. Oznacza to, że klasa współpracuje z projektantami .NET programu Visual Studio w czasie projektowania. Gdy deweloperzy używają projektanta do tworzenia silnie typiowanych zestawów danych i silnie typiowanych połączeń w programie Visual Studio .NET, silnie typizowane parametry połączenia klasy konstruktora będą wyświetlać właściwości skojarzone z typem, a także będą miały konwertery, które mogą mapować typowe wartości znanych kluczy.

Deweloperzy, którzy muszą tworzyć parametry połączenia w ramach aplikacji, mogą używać OracleConnectionStringBuilder klasy do tworzenia i modyfikowania parametrów połączenia. Klasa OracleConnectionStringBuilder ułatwia również zarządzanie parametrami połączenia przechowywanymi w pliku konfiguracji aplikacji.

Funkcja OracleConnectionStringBuilder wykonuje testy prawidłowych par klucz/wartość. W związku z tym nie można użyć tej klasy do tworzenia nieprawidłowych parametrów połączenia. Próba dodania nieprawidłowych par zgłosi wyjątek. Klasa OracleConnectionStringBuilder utrzymuje stałą kolekcję synonimów, a w razie potrzeby może wykonać wymagane tłumaczenie, aby przekonwertować z synonimu na odpowiednią dobrze znaną nazwę klucza. Jeśli na przykład używasz Item[] właściwości do pobierania wartości, możesz określić ciąg zawierający dowolny synonim potrzebnego klucza. Zobacz właściwość , Item[] aby uzyskać pełną listę dopuszczalnych synonimów.

Uchwyty OracleConnectionStringBuilder próbują wstawić złośliwe wpisy. Na przykład poniższy kod używający właściwości domyślnej Item[] (indeksator w języku C#) poprawnie unika zagnieżdżonej pary klucz/wartość.

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);  

Wynik jest następujący parametry połączenia, który obsługuje nieprawidłową wartość w bezpieczny sposób, umieszczając wartość identyfikatora użytkownika w cudzysłowach:

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

Konstruktory

OracleConnectionStringBuilder()	Przestarzałe. Inicjuje nowe wystąpienie klasy OracleConnectionStringBuilder.
OracleConnectionStringBuilder(String)	Przestarzałe. Inicjuje nowe wystąpienie klasy OracleConnectionStringBuilder. Podany parametry połączenia dostarcza dane dla informacji o połączeniu wewnętrznym wystąpienia.

Właściwości

BrowsableConnectionString	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy właściwość jest widoczna ConnectionString w projektanci programu Visual Studio. (Odziedziczone po DbConnectionStringBuilder)
ConnectionString	Przestarzałe. Pobiera lub ustawia parametry połączenia skojarzone z elementem DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder)
Count	Przestarzałe. Pobiera bieżącą liczbę kluczy zawartych we ConnectionString właściwości . (Odziedziczone po DbConnectionStringBuilder)
DataSource	Przestarzałe. Pobiera lub ustawia nazwę źródła danych Oracle do nawiązania połączenia.
Enlist	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy program puli automatycznie zaciąga połączenie w bieżącym kontekście transakcji wątku tworzenia.
IntegratedSecurity	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy "Identyfikator użytkownika" i "Hasło" są określone w połączeniu (gdy false) lub czy bieżące poświadczenia konta systemu Windows są używane do uwierzytelniania (gdy true).
IsFixedSize	Przestarzałe. Pobiera wartość wskazującą, czy element OracleConnectionStringBuilder ma stały rozmiar.
IsReadOnly	Przestarzałe. Pobiera wartość wskazującą, czy DbConnectionStringBuilder element jest tylko do odczytu. (Odziedziczone po DbConnectionStringBuilder)
Item[String]	Przestarzałe. Pobiera lub ustawia wartość skojarzona z określonym kluczem. W języku C# ta właściwość jest indeksatorem.
Keys	Przestarzałe. Pobiera element ICollection zawierający klucze w obiekcie OracleConnectionStringBuilder.
LoadBalanceTimeout	Przestarzałe. Pobiera lub ustawia minimalny czas (w sekundach) połączenia na żywo w puli połączeń przed jego usunięciem.
MaxPoolSize	Przestarzałe. Pobiera lub ustawia maksymalną liczbę połączeń dozwolonych w puli połączeń dla tej konkretnej parametry połączenia.
MinPoolSize	Przestarzałe. Pobiera lub ustawia minimalną liczbę połączeń dozwolonych w puli połączeń dla tego konkretnego parametry połączenia.
OmitOracleConnectionName	Przestarzałe. Pobiera lub ustawia flagę umożliwiającą wycofywanie transakcji we wcześniejszych wersjach programu Oracle (wcześniejszych niż 8.1.7.4.1).
Password	Przestarzałe. Pobiera lub ustawia hasło dla konta Oracle.
PersistSecurityInfo	Przestarzałe. Pobiera lub ustawia wartość logiczną wskazującą, czy informacje poufne zabezpieczeń, takie jak hasło, nie są zwracane w ramach połączenia, jeśli połączenie jest otwarte lub kiedykolwiek było otwarte.
Pooling	Przestarzałe. Pobiera lub ustawia wartość logiczną wskazującą, czy połączenie zostanie w puli, czy każde połączenie zostanie jawnie otwarte za każdym razem, gdy jest wymagane połączenie.
Unicode	Przestarzałe. Pobiera lub ustawia wartość logiczną, która wskazuje, czy klient obsługuje funkcje Unicode dostępne w późniejszych klientach Oracle, czy też nie obsługuje formatu Unicode.
UserID	Przestarzałe. Pobiera lub ustawia identyfikator użytkownika, który ma być używany podczas nawiązywania połączenia z bazą danych Oracle.
Values	Przestarzałe. Pobiera element ICollection zawierający wartości w obiekcie OracleConnectionStringBuilder.

Metody

Add(String, Object)	Przestarzałe. Dodaje wpis z określonym kluczem i wartością do elementu DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder)
Clear()	Przestarzałe. Czyści zawartość OracleConnectionStringBuilder wystąpienia.
ClearPropertyDescriptors()	Przestarzałe. Czyści kolekcję PropertyDescriptor obiektów na skojarzonym DbConnectionStringBuilderobiekcie . (Odziedziczone po DbConnectionStringBuilder)
ContainsKey(String)	Przestarzałe. Określa, czy element OracleConnectionStringBuilder zawiera określony klucz.
Equals(Object)	Przestarzałe. Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
EquivalentTo(DbConnectionStringBuilder)	Przestarzałe. Porównuje informacje o połączeniu w tym DbConnectionStringBuilder obiekcie z informacjami o połączeniu w podanym obiekcie. (Odziedziczone po DbConnectionStringBuilder)
GetHashCode()	Przestarzałe. Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetProperties(Hashtable)	Przestarzałe. Wypełnia element podany Hashtable przy użyciu informacji o wszystkich właściwościach tego obiektu DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder)
GetType()	Przestarzałe. Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Przestarzałe. Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Remove(String)	Przestarzałe. Usuwa wpis z określonym kluczem OracleConnectionStringBuilder z wystąpienia.
ShouldSerialize(String)	Przestarzałe. Wskazuje, czy określony klucz istnieje w tym OracleConnectionStringBuilder wystąpieniu.
ToString()	Przestarzałe. Zwraca parametry połączenia skojarzone z tym DbConnectionStringBuilderelementem . (Odziedziczone po DbConnectionStringBuilder)
TryGetValue(String, Object)	Przestarzałe. Pobiera wartość odpowiadającą podanemu kluczowi z tego OracleConnectionStringBuilderelementu .

Jawne implementacje interfejsu

ICollection.CopyTo(Array, Int32)	Przestarzałe. Kopiuje elementy ICollection elementu do obiektu Array, zaczynając od określonego Array indeksu. (Odziedziczone po DbConnectionStringBuilder)
ICollection.IsSynchronized	Przestarzałe. Pobiera wartość wskazującą, czy dostęp do elementu ICollection jest synchronizowany (bezpieczny wątk). (Odziedziczone po DbConnectionStringBuilder)
ICollection.SyncRoot	Przestarzałe. Pobiera obiekt, który może służyć do synchronizowania dostępu do obiektu ICollection. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Przestarzałe. Zwraca kolekcję atrybutów niestandardowych dla tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Przestarzałe. Zwraca nazwę klasy tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Przestarzałe. Zwraca nazwę tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Przestarzałe. Zwraca konwerter typów dla tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Przestarzałe. Zwraca zdarzenie domyślne dla tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Przestarzałe. Zwraca właściwość domyślną dla tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Przestarzałe. Zwraca edytor określonego typu dla tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Przestarzałe. Zwraca zdarzenia dla tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Przestarzałe. Zwraca zdarzenia dla tego wystąpienia składnika przy użyciu określonej tablicy atrybutów jako filtru. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Przestarzałe. Zwraca właściwości tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Przestarzałe. Zwraca właściwości tego wystąpienia składnika przy użyciu tablicy atrybutów jako filtru. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Przestarzałe. Zwraca obiekt, który zawiera właściwość opisaną przez deskryptor określonej właściwości. (Odziedziczone po DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Przestarzałe. Dodaje element z podanym kluczem i wartością IDictionary do obiektu. (Odziedziczone po DbConnectionStringBuilder)
IDictionary.Contains(Object)	Przestarzałe. Określa, czy IDictionary obiekt zawiera element z określonym kluczem. (Odziedziczone po DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Przestarzałe. IDictionaryEnumerator Zwraca obiekt dla IDictionary obiektu. (Odziedziczone po DbConnectionStringBuilder)
IDictionary.Item[Object]	Przestarzałe. Pobiera lub ustawia element przy użyciu określonego klucza. (Odziedziczone po DbConnectionStringBuilder)
IDictionary.Remove(Object)	Przestarzałe. Usuwa element z określonym kluczem IDictionary z obiektu. (Odziedziczone po DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Przestarzałe. Zwraca moduł wyliczający, który iteruje po kolekcji. (Odziedziczone po DbConnectionStringBuilder)

Metody rozszerzania

Cast<TResult>(IEnumerable)	Przestarzałe. Rzutuje elementy obiektu IEnumerable na określony typ.
OfType<TResult>(IEnumerable)	Przestarzałe. Filtruje elementy IEnumerable elementu na podstawie określonego typu.
AsParallel(IEnumerable)	Przestarzałe. Umożliwia równoległość zapytania.
AsQueryable(IEnumerable)	Przestarzałe. Konwertuje element IEnumerable na .IQueryable

Zobacz też

• Kompilowanie parametrów połączenia