OracleConnectionStringBuilder Třída

Definice

Obor názvů:

System.Data.OracleClient

Sestavení:

System.Data.OracleClient.dll

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řídou .

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

Dědičnost

Object

DbConnectionStringBuilder

OracleConnectionStringBuilder

Atributy

TypeConverterAttribute ObsoleteAttribute

Příklady

Následující konzolová aplikace sestaví připojovací řetězce pro databázi Oracle. Kód používá OracleConnectionStringBuilder třídu k vytvoření připojovací řetězec a pak předá ConnectionString vlastnost OracleConnectionStringBuilder instance konstruktoru třídy připojení. Příklad také parsuje existující připojovací řetězec a ukazuje různé způsoby manipulace s obsahem připojovací řetězec.

Poznámka

Tento příklad obsahuje heslo, které ukazuje, jak OracleConnectionStringBuilder funguje s připojovacími řetězci. Ve vašich aplikacích doporučujeme používat ověřování systému Windows. Pokud je nutné použít heslo, nevkládejte do své aplikace pevně zakódované heslo.

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

Poznámky

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

Tvůrci připojovací řetězec 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í řetězec poskytuje vlastnosti silného typu odpovídající známým párům klíč/hodnota povoleným 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 vytváření datových sad se silnými typy a připojení silného typu v rámci visual Studio .NET, třída připojovací řetězec tvůrce silného typu zobrazí vlastnosti přidružené k jejímu typu a bude mít také převaděče, které mohou mapovat společné hodnoty pro známé klíče.

Vývojáři, kteří potřebují vytvořit připojovací řetězce jako součást aplikací, můžou pomocí OracleConnectionStringBuilder třídy 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.

Nástroj OracleConnectionStringBuilder provádí kontroly platných párů klíč/hodnota. Proto nelze tuto třídu použít k vytvoření neplatných připojovacích řetězců. Při pokusu o přidání neplatných párů 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 pro převod ze synonyma na odpovídající známý název klíče. Když například použijete Item[] vlastnost 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 Item[] vlastnosti .

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

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

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

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

Konstruktory

OracleConnectionStringBuilder()	Zastaralé. Inicializuje novou instanci OracleConnectionStringBuilder třídy .
OracleConnectionStringBuilder(String)	Zastaralé. Inicializuje novou instanci OracleConnectionStringBuilder třídy . Poskytnutá 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 ConnectionString je vlastnost 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 vlastnosti ConnectionString . (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á označuje, zda nástroj pro sdružování automaticky zařazuje připojení do aktuálního kontextu transakce vlákna vytváření.
IntegratedSecurity	Zastaralé. Získá nebo nastaví hodnotu, která označuje, zda "ID uživatele" a "Heslo" jsou zadány v připojení (když false) nebo zda se k ověřování používají přihlašovací údaje aktuálního úč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 připojení bylo aktivní ve fondu připojení před jeho odebráním.
MaxPoolSize	Zastaralé. Získá nebo nastaví maximální počet připojení povolený ve fondu připojení pro tuto konkrétní připojovací řetězec.
MinPoolSize	Zastaralé. Získá nebo nastaví minimální počet připojení povolený 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í transakce 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, zda informace citlivé na zabezpečení, jako je heslo, není vrácen jako součást připojení, pokud připojení je otevřené nebo bylo 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 budou explicitně otevřeny při každém vyžádání připojení.
Unicode	Zastaralé. Získá nebo nastaví logickou hodnotu, která označuje, zda klient podporuje funkce Unicode k dispozici v pozdějších klientech Oracle, nebo pokud je bez 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 objektu DbConnectionStringBuilder. (Zděděno od DbConnectionStringBuilder)
Clear()	Zastaralé. Vymaže obsah OracleConnectionStringBuilder instance.
ClearPropertyDescriptors()	Zastaralé. Vymaže kolekci PropertyDescriptor objektů v přidruženém DbConnectionStringBuilderobjektu . (Zděděno od DbConnectionStringBuilder)
ContainsKey(String)	Zastaralé. Určuje, zda obsahuje OracleConnectionStringBuilder konkrétní klíč.
Equals(Object)	Zastaralé. Určí, zda se zadaný objekt rovná 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í hashovací funkce. (Zděděno od Object)
GetProperties(Hashtable)	Zastaralé. Vyplní zadaný Hashtable objekt informacemi o všech vlastnostech tohoto DbConnectionStringBuilderobjektu . (Zděděno od DbConnectionStringBuilder)
GetType()	Zastaralé. Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Zastaralé. Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
Remove(String)	Zastaralé. Odebere z instance položku se zadaným OracleConnectionStringBuilder klíčem.
ShouldSerialize(String)	Zastaralé. Určuje, zda zadaný klíč existuje v této OracleConnectionStringBuilder instanci.
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 objektu ICollectionArraydo , počínaje konkrétním Array indexem. (Zděděno od DbConnectionStringBuilder)
ICollection.IsSynchronized	Zastaralé. Získá hodnotu označující, zda přístup k objektu ICollection je synchronizován (bezpečný pro přístup z více vláken). (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 filtr. (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 filtr. (Zděděno od DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Zastaralé. Vrátí objekt, který obsahuje vlastnost popsanou zadaným popisovačem 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é. IDictionaryEnumerator Vrátí objekt pro IDictionary objekt . (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é. Vrací enumerátor procházející kolekci. (Zděděno od DbConnectionStringBuilder)

Metody rozšíření

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

Viz také

• Vytváření připojovacích řetězců