OracleConnectionStringBuilder Classe

Definizione

Spazio dei nomi:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Attenzione

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

Fornisce un mezzo per creare e gestire facilmente il contenuto delle stringhe di connessione utilizzate dalla classe OracleConnection.

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

Ereditarietà

Object

DbConnectionStringBuilder

OracleConnectionStringBuilder

Attributi

TypeConverterAttribute ObsoleteAttribute

Esempio

L'applicazione console seguente compila stringhe di connessione per un database Oracle. Il codice usa una OracleConnectionStringBuilder classe per creare la stringa di connessione e quindi passa la ConnectionString proprietà dell'istanza OracleConnectionStringBuilder al costruttore della classe di connessione. L'esempio analizza anche un stringa di connessione esistente e illustra vari modi di modificare il contenuto dell'stringa di connessione.

Nota

In questo esempio è inclusa una password per dimostrare il funzionamento di OracleConnectionStringBuilder con le stringhe di connessione. Nelle applicazioni, è consigliabile utilizzare Windows Authentication. Quando è necessario utilizzare una password, non includere password hardcoded nell'applicazione.

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

Commenti

Questo tipo è deprecato e verrà rimosso in una versione futura di .NET Framework. Per altre informazioni, vedere Oracle e ADO.NET.

I generatori di stringa di connessione consentono agli sviluppatori di creare a livello di codice stringhe di connessione corrette a livello di codice e di analizzare e ricompilare le stringhe di connessione esistenti, usando proprietà e metodi della classe. Il generatore di stringa di connessione fornisce proprietà fortemente tipizzata corrispondenti alle coppie chiave/valore note consentite da Oracle. La classe OracleConnectionStringBuilder implementa l'interfaccia ICustomTypeDescriptor. Ciò significa che la classe funziona con i progettisti .NET di Visual Studio in fase di progettazione. Quando gli sviluppatori usano la finestra di progettazione per creare set di dati fortemente tipizzati e connessioni fortemente tipizzati all'interno di Visual Studio .NET, la classe generatore di stringa di connessione fortemente tipizzata visualizzerà le proprietà associate al relativo tipo e avrà anche convertitori che possono eseguire il mapping di valori comuni per chiavi note.

Gli sviluppatori che devono creare stringhe di connessione come parte delle applicazioni possono utilizzare la classe OracleConnectionStringBuilder per compilare e modificare tali stringhe. La OracleConnectionStringBuilder classe semplifica anche la gestione delle stringhe di connessione archiviate in un file di configurazione dell'applicazione.

L'oggetto OracleConnectionStringBuilder non esegue alcuna verifica sulla validità delle coppie chiave/valore. Pertanto, questa classe non può essere usata per creare stringhe di connessione non valide. Il tentativo di aggiungere coppie non valide genererà un'eccezione. La OracleConnectionStringBuilder classe gestisce una raccolta fissa di sinonimi e, se necessario, può eseguire la traduzione necessaria per convertire da un sinonimo al nome di chiave noto corrispondente. Ad esempio, quando si usa la Item[] proprietà per recuperare un valore, è possibile specificare una stringa contenente qualsiasi sinonimo per la chiave necessaria. Per un elenco completo di sinonimo accettabili, vedere la proprietà Item[].

Gli OracleConnectionStringBuilder handle tentano di inserire voci dannose. Ad esempio, il codice seguente usa la proprietà predefinita Item[] (l'indicizzatore, in C#) esegue correttamente l'escape della coppia chiave/valore annidata.

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

Il risultato è il stringa di connessione seguente che gestisce il valore non valido in modo sicuro racchiudendo il valore ID utente nelle virgolette:

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

Costruttori

OracleConnectionStringBuilder()	Obsoleti. Inizializza una nuova istanza della classe OracleConnectionStringBuilder.
OracleConnectionStringBuilder(String)	Obsoleti. Inizializza una nuova istanza della classe OracleConnectionStringBuilder. La stringa di connessione indicata fornisce i dati per le informazioni di connessione interne dell'istanza.

Proprietà

BrowsableConnectionString	Obsoleti. Ottiene o imposta un valore che indica se la proprietà ConnectionString è visibile nelle finestre di progettazione di Visual Studio. (Ereditato da DbConnectionStringBuilder)
ConnectionString	Obsoleti. Ottiene o imposta la stringa di connessione associata all'oggetto DbConnectionStringBuilder. (Ereditato da DbConnectionStringBuilder)
Count	Obsoleti. Ottiene il numero corrente di chiavi contenute all'interno della proprietà ConnectionString. (Ereditato da DbConnectionStringBuilder)
DataSource	Obsoleti. Ottiene o imposta il nome dell'origine dati Oracle a cui connettersi.
Enlist	Obsoleti. Ottiene o imposta un valore che indica se il pool inserisce automaticamente la connessione nel contesto della transazione corrente del thread di creazione.
IntegratedSecurity	Obsoleti. Ottiene o imposta un valore che indica se nella connessione sono stati specificati "User ID" e "Password", quando viene restituito false, oppure se per l'autenticazione vengono utilizzate le credenziali dell'account di Windows corrente, quando viene restituito true.
IsFixedSize	Obsoleti. Ottiene un valore che indica se le dimensioni dell'oggetto OracleConnectionStringBuilder sono fisse.
IsReadOnly	Obsoleti. Ottiene un valore che indica se DbConnectionStringBuilder è di sola lettura. (Ereditato da DbConnectionStringBuilder)
Item[String]	Obsoleti. Ottiene o imposta il valore associato alla chiave specificata. In C# questa proprietà è l'indicizzatore.
Keys	Obsoleti. Ottiene un oggetto ICollection che contiene le chiavi presenti in OracleConnectionStringBuilder.
LoadBalanceTimeout	Obsoleti. Ottiene o imposta il tempo minimo, espresso in secondi, di permanenza della connessione nel pool prima di essere rimossa.
MaxPoolSize	Obsoleti. Ottiene o imposta il numero massimo di connessioni consentite nel pool di connessioni per la stringa di connessione specificata.
MinPoolSize	Obsoleti. Ottiene o imposta il numero minimo di connessioni consentite nel pool di connessioni per la stringa di connessione specificata.
OmitOracleConnectionName	Obsoleti. Ottiene o imposta il flag che consente i rollback delle transazioni sulle versioni precedenti di Oracle (anteriori alla versione 8.1.7.4.1).
Password	Obsoleti. Ottiene o imposta la password per l'account Oracle.
PersistSecurityInfo	Obsoleti. Ottiene o imposta un valore booleano che indica se le informazioni sensibili alla sicurezza, quali la password, non vengono restituite come parte della connessione se quest'ultima è aperta o è già stata aperta.
Pooling	Obsoleti. Ottiene o imposta un valore booleano che indica se la connessione verrà inserita nel pool o se ciascuna connessione verrà aperta esplicitamente a ogni richiesta.
Unicode	Obsoleti. Ottiene o imposta un valore booleano che indica se il client supporta la funzionalità Unicode disponibile nei client Oracle più recenti o se non riconosce Unicode.
UserID	Obsoleti. Ottiene o imposta l'ID utente da utilizzare per la connessione a Oracle.
Values	Obsoleti. Ottiene un oggetto ICollection contenente i valori di OracleConnectionStringBuilder.

Metodi

Add(String, Object)	Obsoleti. Aggiunge una voce con la chiave e il valore specificati nell'oggetto DbConnectionStringBuilder. (Ereditato da DbConnectionStringBuilder)
Clear()	Obsoleti. Cancella il contenuto dell'istanza di OracleConnectionStringBuilder.
ClearPropertyDescriptors()	Obsoleti. Cancella la raccolta di oggetti PropertyDescriptor per l'oggetto DbConnectionStringBuilder associato. (Ereditato da DbConnectionStringBuilder)
ContainsKey(String)	Obsoleti. Determina se l'oggetto OracleConnectionStringBuilder contiene una chiave specifica.
Equals(Object)	Obsoleti. Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
EquivalentTo(DbConnectionStringBuilder)	Obsoleti. Confronta le informazioni sulla connessione in questo oggetto DbConnectionStringBuilder con le informazioni sulla connessione nell'oggetto fornito. (Ereditato da DbConnectionStringBuilder)
GetHashCode()	Obsoleti. Funge da funzione hash predefinita. (Ereditato da Object)
GetProperties(Hashtable)	Obsoleti. Compila un oggetto Hashtable fornito con informazioni su tutte le proprietà di DbConnectionStringBuilder. (Ereditato da DbConnectionStringBuilder)
GetType()	Obsoleti. Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Obsoleti. Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove(String)	Obsoleti. Rimuove la voce con la chiave specificata dall'istanza di OracleConnectionStringBuilder.
ShouldSerialize(String)	Obsoleti. Indica se la chiave specificata esiste in questa istanza OracleConnectionStringBuilder.
ToString()	Obsoleti. Restituisce la stringa di connessione associata a questo oggetto DbConnectionStringBuilder. (Ereditato da DbConnectionStringBuilder)
TryGetValue(String, Object)	Obsoleti. Recupera un valore che corrisponde alla chiave fornita da questo oggetto OracleConnectionStringBuilder.

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)	Obsoleti. Copia gli elementi di ICollection in Array a partire da un particolare indice Array. (Ereditato da DbConnectionStringBuilder)
ICollection.IsSynchronized	Obsoleti. Ottiene un valore che indica se l'accesso a ICollection è sincronizzato (thread-safe). (Ereditato da DbConnectionStringBuilder)
ICollection.SyncRoot	Obsoleti. Ottiene un oggetto che può essere usato per sincronizzare l'accesso a ICollection. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Obsoleti. Restituisce una raccolta di attributi personalizzati per questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Obsoleti. Restituisce il nome della classe di questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Obsoleti. Restituisce il nome di questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Obsoleti. Restituisce un convertitore di tipi per questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Obsoleti. Restituisce l'evento predefinito per questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Obsoleti. Restituisce la proprietà predefinita per questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Obsoleti. Restituisce un editor del tipo specificato per questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Obsoleti. Restituisce gli eventi per questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Obsoleti. Restituisce gli eventi per questa istanza di un componente usando come filtro la matrice di attributi specificata. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Obsoleti. Restituisce le proprietà per questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Obsoleti. Restituisce le proprietà per questa istanza di un componente usando come filtro la matrice di attributi. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Obsoleti. Restituisce un oggetto che contiene la proprietà descritta dal descrittore di proprietà specificato. (Ereditato da DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Obsoleti. Aggiunge un elemento con la chiave e il valore forniti all'oggetto IDictionary. (Ereditato da DbConnectionStringBuilder)
IDictionary.Contains(Object)	Obsoleti. Determina se l'oggetto IDictionary contiene un elemento con la chiave specificata. (Ereditato da DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Obsoleti. Restituisce un oggetto IDictionaryEnumerator per l'oggetto IDictionary. (Ereditato da DbConnectionStringBuilder)
IDictionary.Item[Object]	Obsoleti. Ottiene o imposta l'elemento con la chiave specificata. (Ereditato da DbConnectionStringBuilder)
IDictionary.Remove(Object)	Obsoleti. Rimuove dall'oggetto IDictionary l'elemento con la chiave specificata. (Ereditato da DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Obsoleti. Restituisce un enumeratore che consente di eseguire l'iterazione di una raccolta. (Ereditato da DbConnectionStringBuilder)

Metodi di estensione

Cast<TResult>(IEnumerable)	Obsoleti. Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Obsoleti. Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Obsoleti. Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Obsoleti. Converte un oggetto IEnumerable in un oggetto IQueryable.

Vedi anche

• Compilazione delle stringhe di connessione