OracleConnectionStringBuilder Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- 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 |
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. |