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

Uwagi

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

Konstruktory parametrów 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 parametrów połączenia udostępnia silnie typizowane właściwości odpowiadające znanym parom klucz/wartość dozwolonym przez 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 jego typem, a także będą miały konwertery, które mogą mapować wspólne wartości dla znanych kluczy.

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

OracleConnectionStringBuilder wykonuje kontrole 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 jeśli jest to wymagane, może wykonać wymagane tłumaczenie, aby przekonwertować z synonimu na odpowiednią dobrze znaną nazwę klucza. Na przykład w przypadku użycia właściwości Item[] w celu pobrania wartości można określić ciąg zawierający dowolny synonim potrzebnego klucza. Zobacz właściwość Item[], aby uzyskać pełną listę dopuszczalnych synonimów.

OracleConnectionStringBuilder obsługuje próby wstawienia złośliwych wpisów. Na przykład poniższy kod, używając domyślnej właściwości 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;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);

Wynikiem są następujące parametry połączenia, które obsługują nieprawidłową wartość w bezpieczny sposób, umieszczając wartość identyfikatora użytkownika w cudzysłowie:

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

Ostrzeżenie

Firma Microsoft nie zaleca bezpośredniego podawania nazwy użytkownika i hasła, ponieważ jest to niezabezpieczony wzorzec. Jeśli to możliwe, należy użyć bezpieczniejszych przepływów uwierzytelniania, takich jak tożsamości zarządzane dla zasobów platformy Azurelub uwierzytelniania systemu Windows dla programu SQL Server.

Konstruktory

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

Właściwości

BrowsableConnectionString	Przestarzałe. Pobiera lub ustawia wartość wskazującą, czy właściwość ConnectionString jest widoczna dla projektantów programu Visual Studio. (Odziedziczone po DbConnectionStringBuilder)
ConnectionString	Przestarzałe. Pobiera lub ustawia parametry połączenia skojarzone z DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder)
Count	Przestarzałe. Pobiera bieżącą liczbę kluczy zawartych we właściwości ConnectionString. (Odziedziczone po DbConnectionStringBuilder)
DataSource	Przestarzałe. Pobiera lub ustawia nazwę źródła danych Oracle w celu nawiązania połączenia.
Enlist	Przestarzałe. Pobiera lub ustawia wartość, która wskazuje, czy program pooler automatycznie enlists połączenia 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 OracleConnectionStringBuilder ma stały rozmiar.
IsReadOnly	Przestarzałe. Pobiera wartość wskazującą, czy DbConnectionStringBuilder 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 ICollection, który zawiera klucze w OracleConnectionStringBuilder.
LoadBalanceTimeout	Przestarzałe. Pobiera lub ustawia minimalny czas (w sekundach) dla 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 tych określonych parametrów połączenia.
MinPoolSize	Przestarzałe. Pobiera lub ustawia minimalną liczbę połączeń dozwolonych w puli połączeń dla tych określonych parametrów połączenia.
OmitOracleConnectionName	Przestarzałe. Pobiera lub ustawia flagę umożliwiającą wycofywanie transakcji we wcześniejszych wersjach programu Oracle (wcześniejsze 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 przy każdym żądaniu połączenia.
Unicode	Przestarzałe. Pobiera lub ustawia wartość logiczną, która wskazuje, czy klient obsługuje funkcje Unicode dostępne w nowszych klientach Oracle, czy nie jest świadomy 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 ICollection, który zawiera wartości w OracleConnectionStringBuilder.

Metody

Add(String, Object)	Przestarzałe. Dodaje wpis z określonym kluczem i wartością do DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder)
Clear()	Przestarzałe. Czyści zawartość wystąpienia OracleConnectionStringBuilder.
ClearPropertyDescriptors()	Przestarzałe. Czyści kolekcję obiektów PropertyDescriptor na skojarzonym DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder)
ContainsKey(String)	Przestarzałe. Określa, czy OracleConnectionStringBuilder zawiera określony klucz.
Equals(Object)	Przestarzałe. Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
EquivalentTo(DbConnectionStringBuilder)	Przestarzałe. Porównuje informacje o połączeniu w tym obiekcie DbConnectionStringBuilder 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 podaną Hashtable informacjami o wszystkich właściwościach tego DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder)
GetType()	Przestarzałe. Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Przestarzałe. Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
Remove(String)	Przestarzałe. Usuwa wpis z określonym kluczem z wystąpienia OracleConnectionStringBuilder.
ShouldSerialize(String)	Przestarzałe. Wskazuje, czy określony klucz istnieje w tym wystąpieniu OracleConnectionStringBuilder.
ToString()	Przestarzałe. Zwraca parametry połączenia skojarzone z tym DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder)
TryGetValue(String, Object)	Przestarzałe. Pobiera wartość odpowiadającą podanemu kluczowi z tego OracleConnectionStringBuilder.

Jawne implementacje interfejsu

ICollection.CopyTo(Array, Int32)	Przestarzałe. Kopiuje elementy ICollection do Array, począwszy od określonego indeksu Array. (Odziedziczone po DbConnectionStringBuilder)
ICollection.IsSynchronized	Przestarzałe. Pobiera wartość wskazującą, czy dostęp do ICollection jest synchronizowany (bezpieczny wątek). (Odziedziczone po DbConnectionStringBuilder)
ICollection.SyncRoot	Przestarzałe. Pobiera obiekt, który może służyć do synchronizowania dostępu do 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 określony deskryptor właściwości. (Odziedziczone po DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Przestarzałe. Dodaje element z podanym kluczem i wartością do obiektu IDictionary. (Odziedziczone po DbConnectionStringBuilder)
IDictionary.Contains(Object)	Przestarzałe. Określa, czy obiekt IDictionary zawiera element z określonym kluczem. (Odziedziczone po DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Przestarzałe. Zwraca obiekt IDictionaryEnumerator dla obiektu IDictionary. (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 z obiektu IDictionary. (Odziedziczone po DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Przestarzałe. Zwraca moduł wyliczający, który iteruje za pośrednictwem kolekcji. (Odziedziczone po DbConnectionStringBuilder)

Metody rozszerzania

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

Zobacz też

• kompilowanie parametrów połączenia