OracleConnectionStringBuilder Classe

Definizione

Attenzione

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

Fornisce un modo semplice per creare e gestire il contenuto delle stringhe di connessione usate dalla classe OracleConnection.

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
Ereditarietà
OracleConnectionStringBuilder
Attributi

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

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

Il OracleConnectionStringBuilder esegue controlli per le coppie chiave/valore valide. 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 classe OracleConnectionStringBuilder gestisce una raccolta fissa di sinonimi e, quando necessario, può eseguire la conversione necessaria per eseguire la conversione da un sinonimo al nome di chiave noto corrispondente. Ad esempio, quando si usa la proprietà Item[] per recuperare un valore, è possibile specificare una stringa contenente qualsiasi sinonimo della chiave necessaria. Per un elenco completo dei sinonimi accettabili, vedere la proprietà Item[].

Il OracleConnectionStringBuilder gestisce i tentativi di inserimento di voci dannose. Ad esempio, il codice seguente, usando la proprietà Item[] predefinita (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;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);

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

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

Avvertimento

Microsoft non consiglia di fornire direttamente il nome utente e la password, perché si tratta di un modello non sicuro. Se possibile, usare flussi di autenticazione più sicuri, ad esempio identità gestite per le risorse di Azureo l'autenticazione di Windows per SQL Server.

Costruttori

OracleConnectionStringBuilder()
Obsoleti.

Inizializza una nuova istanza della classe OracleConnectionStringBuilder.

OracleConnectionStringBuilder(String)
Obsoleti.

Inizializza una nuova istanza della classe OracleConnectionStringBuilder. La stringa di connessione fornita 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 al DbConnectionStringBuilder.

(Ereditato da DbConnectionStringBuilder)
Count
Obsoleti.

Ottiene il numero corrente di chiavi contenute nella 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 pooler inserisce automaticamente la connessione nel contesto di transazione corrente del thread di creazione.

IntegratedSecurity
Obsoleti.

Ottiene o imposta un valore che indica se nella connessione vengono specificati "ID utente" e "Password" (quando false) o se le credenziali dell'account di Windows corrente vengono utilizzate per l'autenticazione (quando true).

IsFixedSize
Obsoleti.

Ottiene un valore che indica se il OracleConnectionStringBuilder ha una dimensione fissa.

IsReadOnly
Obsoleti.

Ottiene un valore che indica se il 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 ICollection che contiene le chiavi nel OracleConnectionStringBuilder.

LoadBalanceTimeout
Obsoleti.

Ottiene o imposta il tempo minimo, espresso in secondi, affinché la connessione sia attiva nel pool di connessioni prima che venga rimossa.

MaxPoolSize
Obsoleti.

Ottiene o imposta il numero massimo di connessioni consentite nel pool di connessioni per questa stringa di connessione specifica.

MinPoolSize
Obsoleti.

Ottiene o imposta il numero minimo di connessioni consentite nel pool di connessioni per questa stringa di connessione specifica.

OmitOracleConnectionName
Obsoleti.

Ottiene o imposta il flag che abilita il rollback delle transazioni nelle versioni precedenti di Oracle (precedente 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, ad esempio la password, non vengono restituite come parte della connessione se la connessione è aperta o è mai stata aperta.

Pooling
Obsoleti.

Ottiene o imposta un valore booleano che indica se la connessione verrà inserita in pool o se ogni connessione verrà aperta in modo esplicito ogni volta che viene richiesta la connessione.

Unicode
Obsoleti.

Ottiene o imposta un valore booleano che indica se il client supporta la funzionalità Unicode disponibile nei client Oracle successivi o se non è compatibile con Unicode.

UserID
Obsoleti.

Ottiene o imposta l'ID utente da utilizzare per la connessione a Oracle.

Values
Obsoleti.

Ottiene un ICollection che contiene i valori nella OracleConnectionStringBuilder.

Metodi

Add(String, Object)
Obsoleti.

Aggiunge una voce con la chiave e il valore specificati nella DbConnectionStringBuilder.

(Ereditato da DbConnectionStringBuilder)
Clear()
Obsoleti.

Cancella il contenuto dell'istanza di OracleConnectionStringBuilder.

ClearPropertyDescriptors()
Obsoleti.

Cancella l'insieme di oggetti PropertyDescriptor nell'oggetto associato DbConnectionStringBuilder.

(Ereditato da DbConnectionStringBuilder)
ContainsKey(String)
Obsoleti.

Determina se il 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 di connessione in questo oggetto DbConnectionStringBuilder con le informazioni di connessione nell'oggetto fornito.

(Ereditato da DbConnectionStringBuilder)
GetHashCode()
Obsoleti.

Funge da funzione hash predefinita.

(Ereditato da Object)
GetProperties(Hashtable)
Obsoleti.

Riempie un Hashtable fornito con informazioni su tutte le proprietà di questa DbConnectionStringBuilder.

(Ereditato da DbConnectionStringBuilder)
GetType()
Obsoleti.

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()
Obsoleti.

Crea una copia superficiale del Objectcorrente.

(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 di OracleConnectionStringBuilder.

ToString()
Obsoleti.

Restituisce la stringa di connessione associata a questa DbConnectionStringBuilder.

(Ereditato da DbConnectionStringBuilder)
TryGetValue(String, Object)
Obsoleti.

Recupera un valore corrispondente alla chiave fornita da questo OracleConnectionStringBuilder.

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)
Obsoleti.

Copia gli elementi del ICollection in un Array, a partire da un particolare indice Array.

(Ereditato da DbConnectionStringBuilder)
ICollection.IsSynchronized
Obsoleti.

Ottiene un valore che indica se l'accesso al ICollection è sincronizzato (thread-safe).

(Ereditato da DbConnectionStringBuilder)
ICollection.SyncRoot
Obsoleti.

Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso al 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 utilizzando la matrice di attributi specificata come filtro.

(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 utilizzando la matrice di attributi come filtro.

(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 specificati 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 l'elemento con la chiave specificata dall'oggetto IDictionary.

(Ereditato da DbConnectionStringBuilder)
IEnumerable.GetEnumerator()
Obsoleti.

Restituisce un enumeratore che scorre un insieme.

(Ereditato da DbConnectionStringBuilder)

Metodi di estensione

Cast<TResult>(IEnumerable)
Obsoleti.

Esegue il cast degli elementi di un IEnumerable al tipo specificato.

OfType<TResult>(IEnumerable)
Obsoleti.

Filtra gli elementi di un IEnumerable in base a un tipo specificato.

AsParallel(IEnumerable)
Obsoleti.

Abilita la parallelizzazione di una query.

AsQueryable(IEnumerable)
Obsoleti.

Converte un IEnumerable in un IQueryable.

Si applica a

Vedi anche