OracleConnectionStringBuilder Třída

Reference

Definice

Obor názvů:: System.Data.OracleClient

Sestavení:: System.Data.OracleClient.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Upozornění

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

Poskytuje jednoduchý způsob, jak vytvořit a spravovat obsah připojovacích řetězců používaných OracleConnection třídy.

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

Dědičnost: Object

DbConnectionStringBuilder
OracleConnectionStringBuilder

Atributy: TypeConverterAttribute ObsoleteAttribute

Poznámky

Tento typ je zastaralý a bude odebrán v budoucí verzi rozhraní .NET Framework. Další informace naleznete v tématu Oracle a ADO.NET.

Tvůrci připojovacích řetězců umožňují vývojářům programově vytvářet syntakticky správné připojovací řetězce a parsovat a znovu sestavit existující připojovací řetězce pomocí vlastností a metod třídy. Tvůrce připojovacích řetězců poskytuje vlastnosti silného typu odpovídající známým párům klíč/hodnota povolených Oraclem. Třída OracleConnectionStringBuilder implementuje rozhraní ICustomTypeDescriptor. To znamená, že třída pracuje s návrháři sady Visual Studio .NET v době návrhu. Když vývojáři používají návrháře k sestavení silně typovaných datových sad a připojení silného typu v sadě Visual Studio .NET, třída tvůrce připojovacích řetězců silného typu zobrazí vlastnosti přidružené k jeho typu a bude mít také převaděče, které mohou mapovat společné hodnoty známých klíčů.

Vývojáři, kteří potřebují vytvářet připojovací řetězce jako součást aplikací, mohou pomocí třídy OracleConnectionStringBuilder vytvářet a upravovat připojovací řetězce. Třída OracleConnectionStringBuilder také usnadňuje správu připojovacích řetězců uložených v konfiguračním souboru aplikace.

OracleConnectionStringBuilder provádí kontroly platných párů klíč/hodnota. Proto tuto třídu nelze použít k vytvoření neplatných připojovacích řetězců. Při pokusu o přidání neplatných dvojic dojde k výjimce. Třída OracleConnectionStringBuilder udržuje pevnou kolekci synonym a v případě potřeby může provést požadovaný překlad, který převede z synonyma na odpovídající dobře známý název klíče. Když například použijete vlastnost Item[] k načtení hodnoty, můžete zadat řetězec, který obsahuje jakékoli synonymum pro klíč, který potřebujete. Úplný seznam přijatelných synonym najdete ve vlastnosti Item[].

OracleConnectionStringBuilder zpracovává pokusy o vložení škodlivých položek. Například následující kód s použitím výchozí vlastnosti Item[] (indexer v jazyce C#) správně unikne dvojici vnořených klíč/hodnota.

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

Výsledkem je následující připojovací řetězec, který bezpečně zpracovává neplatnou hodnotu uzavřením hodnoty ID uživatele do uvozovek:

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

Varování

Microsoft nedoporučuje zadat vaše uživatelské jméno a heslo přímo, protože se jedná o nezabezpečený vzor. Pokud je to možné, používejte bezpečnější toky ověřování, jako jsou spravované identity pro prostředky Azurenebo ověřování systému Windows pro SQL Server.

Konstruktory

OracleConnectionStringBuilder()	Zastaralé. Inicializuje novou instanci OracleConnectionStringBuilder třídy.
OracleConnectionStringBuilder(String)	Zastaralé. Inicializuje novou instanci OracleConnectionStringBuilder třídy. Zadaný připojovací řetězec poskytuje data pro interní informace o připojení instance.

Vlastnosti

BrowsableConnectionString	Zastaralé. Získá nebo nastaví hodnotu, která označuje, zda je vlastnost ConnectionString viditelná v návrhářích sady Visual Studio. (Zděděno od DbConnectionStringBuilder)
ConnectionString	Zastaralé. Získá nebo nastaví připojovací řetězec přidružený k DbConnectionStringBuilder. (Zděděno od DbConnectionStringBuilder)
Count	Zastaralé. Získá aktuální počet klíčů, které jsou obsaženy v ConnectionString vlastnost. (Zděděno od DbConnectionStringBuilder)
DataSource	Zastaralé. Získá nebo nastaví název zdroje dat Oracle pro připojení.
Enlist	Zastaralé. Získá nebo nastaví hodnotu, která určuje, zda pooler automaticky zařazuje připojení do kontextu aktuální transakce vlákna vytvoření.
IntegratedSecurity	Zastaralé. Získá nebo nastaví hodnotu, která označuje, zda jsou v připojení (při `false`) zadány "ID uživatele" a "Heslo", nebo jestli se pro ověřování používají aktuální přihlašovací údaje účtu Systému Windows (když `true`).
IsFixedSize	Zastaralé. Získá hodnotu, která označuje, zda OracleConnectionStringBuilder má pevnou velikost.
IsReadOnly	Zastaralé. Získá hodnotu, která označuje, zda DbConnectionStringBuilder je jen pro čtení. (Zděděno od DbConnectionStringBuilder)
Item[String]	Zastaralé. Získá nebo nastaví hodnotu přidruženou k zadanému klíči. V jazyce C# je tato vlastnost indexerem.
Keys	Zastaralé. Získá ICollection, který obsahuje klíče v OracleConnectionStringBuilder.
LoadBalanceTimeout	Zastaralé. Získá nebo nastaví minimální dobu v sekundách, aby se připojení živé ve fondu připojení před jeho odebráním.
MaxPoolSize	Zastaralé. Získá nebo nastaví maximální počet připojení povolených ve fondu připojení pro tento konkrétní připojovací řetězec.
MinPoolSize	Zastaralé. Získá nebo nastaví minimální počet připojení povolených ve fondu připojení pro tento konkrétní připojovací řetězec.
OmitOracleConnectionName	Zastaralé. Získá nebo nastaví příznak, který umožňuje vrácení transakcí zpět v dřívějších verzích Oracle (před 8.1.7.4.1).
Password	Zastaralé. Získá nebo nastaví heslo pro účet Oracle.
PersistSecurityInfo	Zastaralé. Získá nebo nastaví logickou hodnotu, která označuje, jestli informace citlivé na zabezpečení, například heslo, se nevrátí jako součást připojení, pokud je připojení otevřené nebo je někdy v otevřeném stavu.
Pooling	Zastaralé. Získá nebo nastaví logickou hodnotu, která označuje, zda bude připojení ve fondu, nebo zda bude každé připojení explicitně otevřeno při každém vyžádání připojení.
Unicode	Zastaralé. Získá nebo nastaví logickou hodnotu, která indikuje, zda klient podporuje funkce Unicode dostupné v pozdějších klientech Oracle, nebo pokud to není unicode.
UserID	Zastaralé. Získá nebo nastaví ID uživatele, které se má použít při připojování k Oracle.
Values	Zastaralé. Získá ICollection, který obsahuje hodnoty v OracleConnectionStringBuilder.

Metody

Add(String, Object)	Zastaralé. Přidá položku se zadaným klíčem a hodnotou do DbConnectionStringBuilder. (Zděděno od DbConnectionStringBuilder)
Clear()	Zastaralé. Vymaže obsah instance OracleConnectionStringBuilder.
ClearPropertyDescriptors()	Zastaralé. Vymaže kolekci PropertyDescriptor objektů v přidružené DbConnectionStringBuilder. (Zděděno od DbConnectionStringBuilder)
ContainsKey(String)	Zastaralé. Určuje, zda OracleConnectionStringBuilder obsahuje konkrétní klíč.
Equals(Object)	Zastaralé. Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
EquivalentTo(DbConnectionStringBuilder)	Zastaralé. Porovná informace o připojení v tomto DbConnectionStringBuilder objektu s informacemi o připojení v zadaném objektu. (Zděděno od DbConnectionStringBuilder)
GetHashCode()	Zastaralé. Slouží jako výchozí funkce hash. (Zděděno od Object)
GetProperties(Hashtable)	Zastaralé. Vyplní zadaný Hashtable informacemi o všech vlastnostech tohoto DbConnectionStringBuilder. (Zděděno od DbConnectionStringBuilder)
GetType()	Zastaralé. Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Zastaralé. Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
Remove(String)	Zastaralé. Odebere položku se zadaným klíčem z instance OracleConnectionStringBuilder.
ShouldSerialize(String)	Zastaralé. Určuje, zda zadaný klíč existuje v této instanci OracleConnectionStringBuilder.
ToString()	Zastaralé. Vrátí připojovací řetězec přidružený k tomuto DbConnectionStringBuilder. (Zděděno od DbConnectionStringBuilder)
TryGetValue(String, Object)	Zastaralé. Načte hodnotu odpovídající zadanému klíči z tohoto OracleConnectionStringBuilder.

Explicitní implementace rozhraní

ICollection.CopyTo(Array, Int32)	Zastaralé. Zkopíruje prvky ICollection do Arraypočínaje konkrétním indexem Array. (Zděděno od DbConnectionStringBuilder)
ICollection.IsSynchronized	Zastaralé. Získá hodnotu označující, zda je přístup k ICollection synchronizován (bezpečné vlákno). (Zděděno od DbConnectionStringBuilder)
ICollection.SyncRoot	Zastaralé. Získá objekt, který lze použít k synchronizaci přístupu k ICollection. (Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Zastaralé. Vrátí kolekci vlastních atributů pro tuto instanci komponenty. (Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Zastaralé. Vrátí název třídy této instance komponenty. (Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Zastaralé. Vrátí název této instance komponenty. (Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Zastaralé. Vrátí převaděč typů pro tuto instanci komponenty. (Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Zastaralé. Vrátí výchozí událost pro tuto instanci komponenty. (Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Zastaralé. Vrátí výchozí vlastnost pro tuto instanci komponenty. (Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Zastaralé. Vrátí editor zadaného typu pro tuto instanci komponenty. (Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Zastaralé. Vrátí události pro tuto instanci komponenty. (Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Zastaralé. Vrátí události pro tuto instanci komponenty pomocí zadaného pole atributů jako filtru. (Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Zastaralé. Vrátí vlastnosti pro tuto instanci komponenty. (Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Zastaralé. Vrátí vlastnosti pro tuto instanci komponenty pomocí pole atributů jako filtru. (Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Zastaralé. Vrátí objekt, který obsahuje vlastnost popsanou popisovačem zadané vlastnosti. (Zděděno od DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Zastaralé. Přidá prvek se zadaným klíčem a hodnotou do objektu IDictionary. (Zděděno od DbConnectionStringBuilder)
IDictionary.Contains(Object)	Zastaralé. Určuje, zda IDictionary objekt obsahuje prvek se zadaným klíčem. (Zděděno od DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Zastaralé. Vrátí objekt IDictionaryEnumerator pro objekt IDictionary. (Zděděno od DbConnectionStringBuilder)
IDictionary.Item[Object]	Zastaralé. Získá nebo nastaví prvek se zadaným klíčem. (Zděděno od DbConnectionStringBuilder)
IDictionary.Remove(Object)	Zastaralé. Odebere prvek se zadaným klíčem z objektu IDictionary. (Zděděno od DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Zastaralé. Vrátí enumerátor, který iteruje kolekcí. (Zděděno od DbConnectionStringBuilder)

Metody rozšíření

Cast<TResult>(IEnumerable)	Zastaralé. Přetypuje prvky IEnumerable na zadaný typ.
OfType<TResult>(IEnumerable)	Zastaralé. Filtruje prvky IEnumerable na základě zadaného typu.
AsParallel(IEnumerable)	Zastaralé. Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)	Zastaralé. Převede IEnumerable na IQueryable.

Platí pro

Viz také

vytváření připojovacích řetězců

Sdílet prostřednictvím