OracleConnectionStringBuilder Classe

Définition

Espace de noms:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Attention

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

Fournit un moyen simple de créer et de gérer le contenu des chaînes de connexion utilisées par la 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

Héritage

Object

DbConnectionStringBuilder

OracleConnectionStringBuilder

Attributs

TypeConverterAttribute ObsoleteAttribute

Remarques

Ce type est déconseillé et sera supprimé dans une version ultérieure de .NET Framework. Pour plus d’informations, consultez Oracle et ADO.NET.

Les générateurs de chaînes de connexion permettent aux développeurs de créer par programmation des chaînes de connexion correctes par programmation, et d’analyser et de reconstruire des chaînes de connexion existantes, à l’aide de propriétés et de méthodes de la classe. Le générateur de chaînes de connexion fournit des propriétés fortement typées correspondant aux paires clé/valeur connues autorisées par Oracle. La classe OracleConnectionStringBuilder implémente l’interface ICustomTypeDescriptor. Cela signifie que la classe fonctionne avec les concepteurs Visual Studio .NET au moment du design. Lorsque les développeurs utilisent le concepteur pour générer des dataSets fortement typés et des connexions fortement typées au sein de Visual Studio .NET, la classe générateur de chaînes de connexion fortement typée affiche les propriétés associées à son type et possède également des convertisseurs qui peuvent mapper des valeurs communes pour les clés connues.

Les développeurs qui ont besoin de créer des chaînes de connexion dans le cadre d’applications peuvent utiliser la classe OracleConnectionStringBuilder pour générer et modifier des chaînes de connexion. La classe OracleConnectionStringBuilder facilite également la gestion des chaînes de connexion stockées dans un fichier de configuration d’application.

Le OracleConnectionStringBuilder effectue des vérifications pour les paires clé/valeur valides. Par conséquent, cette classe ne peut pas être utilisée pour créer des chaînes de connexion non valides. La tentative d’ajout de paires non valides lève une exception. La classe OracleConnectionStringBuilder conserve une collection fixe de synonymes et, le cas échéant, peut effectuer la traduction requise pour effectuer la conversion d’un synonyme en nom de clé connu correspondant. Par exemple, lorsque vous utilisez la propriété Item[] pour récupérer une valeur, vous pouvez spécifier une chaîne qui contient n’importe quel synonyme de la clé dont vous avez besoin. Consultez la propriété Item[] pour obtenir la liste complète des synonymes acceptables.

Le OracleConnectionStringBuilder gère les tentatives d’insertion d’entrées malveillantes. Par exemple, le code suivant, à l’aide de la propriété Item[] par défaut (l’indexeur, en C#), échappe correctement la paire clé/valeur imbriquée.

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

Le résultat est la chaîne de connexion suivante qui gère la valeur non valide de manière sécurisée en plaçant la valeur d’ID d’utilisateur entre guillemets :

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

Avertissement

Microsoft ne recommande pas de fournir directement votre nom d’utilisateur et votre mot de passe, car il s’agit d’un modèle non sécurisé. Dans la mesure du possible, utilisez des flux d’authentification plus sécurisés, tels que identités managées pour les ressources Azure, ou l’authentification Windows pour SQL Server.

Constructeurs

OracleConnectionStringBuilder()	Obsolète. Initialise une nouvelle instance de la classe OracleConnectionStringBuilder.
OracleConnectionStringBuilder(String)	Obsolète. Initialise une nouvelle instance de la classe OracleConnectionStringBuilder. La chaîne de connexion fournie fournit les données des informations de connexion internes de l’instance.

Propriétés

BrowsableConnectionString	Obsolète. Obtient ou définit une valeur qui indique si la propriété ConnectionString est visible dans les concepteurs Visual Studio. (Hérité de DbConnectionStringBuilder)
ConnectionString	Obsolète. Obtient ou définit la chaîne de connexion associée au DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
Count	Obsolète. Obtient le nombre actuel de clés contenues dans la propriété ConnectionString. (Hérité de DbConnectionStringBuilder)
DataSource	Obsolète. Obtient ou définit le nom de la source de données Oracle à laquelle se connecter.
Enlist	Obsolète. Obtient ou définit une valeur qui indique si l’éditeur de pool inscrit automatiquement la connexion dans le contexte de transaction actuel du thread de création.
IntegratedSecurity	Obsolète. Obtient ou définit une valeur qui indique si « ID utilisateur » et « Mot de passe » sont spécifiés dans la connexion (quand false) ou si les informations d’identification du compte Windows actuel sont utilisées pour l’authentification (quand true).
IsFixedSize	Obsolète. Obtient une valeur qui indique si le OracleConnectionStringBuilder a une taille fixe.
IsReadOnly	Obsolète. Obtient une valeur qui indique si la DbConnectionStringBuilder est en lecture seule. (Hérité de DbConnectionStringBuilder)
Item[String]	Obsolète. Obtient ou définit la valeur associée à la clé spécifiée. En C#, cette propriété est l’indexeur.
Keys	Obsolète. Obtient un ICollection qui contient les clés dans le OracleConnectionStringBuilder.
LoadBalanceTimeout	Obsolète. Obtient ou définit la durée minimale, en secondes, pour que la connexion se trouve dans le pool de connexions avant sa suppression.
MaxPoolSize	Obsolète. Obtient ou définit le nombre maximal de connexions autorisées dans le pool de connexions pour cette chaîne de connexion spécifique.
MinPoolSize	Obsolète. Obtient ou définit le nombre minimal de connexions autorisées dans le pool de connexions pour cette chaîne de connexion spécifique.
OmitOracleConnectionName	Obsolète. Obtient ou définit l’indicateur qui active les restaurations de transaction sur les versions antérieures d’Oracle (antérieures à la version 8.1.7.4.1).
Password	Obsolète. Obtient ou définit le mot de passe du compte Oracle.
PersistSecurityInfo	Obsolète. Obtient ou définit une valeur booléenne qui indique si des informations sensibles à la sécurité, telles que le mot de passe, ne sont pas retournées dans le cadre de la connexion si la connexion est ouverte ou n’a jamais été dans un état ouvert.
Pooling	Obsolète. Obtient ou définit une valeur booléenne qui indique si la connexion sera mise en pool ou si chaque connexion sera explicitement ouverte chaque fois que la connexion est demandée.
Unicode	Obsolète. Obtient ou définit une valeur booléenne qui indique si le client prend en charge les fonctionnalités Unicode disponibles dans les clients Oracle ultérieurs ou s’il n’est pas compatible Unicode.
UserID	Obsolète. Obtient ou définit l’ID utilisateur à utiliser lors de la connexion à Oracle.
Values	Obsolète. Obtient une ICollection qui contient les valeurs dans le OracleConnectionStringBuilder.

Méthodes

Add(String, Object)	Obsolète. Ajoute une entrée avec la clé et la valeur spécifiées dans le DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
Clear()	Obsolète. Efface le contenu de l’instance de OracleConnectionStringBuilder.
ClearPropertyDescriptors()	Obsolète. Efface la collection d’objets PropertyDescriptor sur le DbConnectionStringBuilderassocié. (Hérité de DbConnectionStringBuilder)
ContainsKey(String)	Obsolète. Détermine si le OracleConnectionStringBuilder contient une clé spécifique.
Equals(Object)	Obsolète. Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
EquivalentTo(DbConnectionStringBuilder)	Obsolète. Compare les informations de connexion dans cet objet DbConnectionStringBuilder avec les informations de connexion de l’objet fourni. (Hérité de DbConnectionStringBuilder)
GetHashCode()	Obsolète. Sert de fonction de hachage par défaut. (Hérité de Object)
GetProperties(Hashtable)	Obsolète. Remplit un Hashtable fourni avec des informations sur toutes les propriétés de cette DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
GetType()	Obsolète. Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Obsolète. Crée une copie superficielle du Objectactuel. (Hérité de Object)
Remove(String)	Obsolète. Supprime l’entrée avec la clé spécifiée de l’instance OracleConnectionStringBuilder.
ShouldSerialize(String)	Obsolète. Indique si la clé spécifiée existe dans cette instance OracleConnectionStringBuilder.
ToString()	Obsolète. Retourne la chaîne de connexion associée à cette DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
TryGetValue(String, Object)	Obsolète. Récupère une valeur correspondant à la clé fournie à partir de cette OracleConnectionStringBuilder.

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)	Obsolète. Copie les éléments du ICollection dans un Array, en commençant à un index Array particulier. (Hérité de DbConnectionStringBuilder)
ICollection.IsSynchronized	Obsolète. Obtient une valeur indiquant si l’accès au ICollection est synchronisé (thread safe). (Hérité de DbConnectionStringBuilder)
ICollection.SyncRoot	Obsolète. Obtient un objet qui peut être utilisé pour synchroniser l’accès au ICollection. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Obsolète. Retourne une collection d’attributs personnalisés pour cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Obsolète. Retourne le nom de classe de cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Obsolète. Retourne le nom de cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Obsolète. Retourne un convertisseur de type pour cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Obsolète. Retourne l’événement par défaut pour cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Obsolète. Retourne la propriété par défaut pour cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Obsolète. Retourne un éditeur du type spécifié pour cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Obsolète. Retourne les événements de cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Obsolète. Retourne les événements de cette instance d’un composant à l’aide du tableau d’attributs spécifié en tant que filtre. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Obsolète. Retourne les propriétés de cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Obsolète. Retourne les propriétés de cette instance d’un composant à l’aide du tableau d’attributs en tant que filtre. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Obsolète. Retourne un objet qui contient la propriété décrite par le descripteur de propriété spécifié. (Hérité de DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Obsolète. Ajoute un élément avec la clé et la valeur fournies à l’objet IDictionary. (Hérité de DbConnectionStringBuilder)
IDictionary.Contains(Object)	Obsolète. Détermine si l’objet IDictionary contient un élément avec la clé spécifiée. (Hérité de DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Obsolète. Retourne un objet IDictionaryEnumerator pour l’objet IDictionary. (Hérité de DbConnectionStringBuilder)
IDictionary.Item[Object]	Obsolète. Obtient ou définit l’élément avec la clé spécifiée. (Hérité de DbConnectionStringBuilder)
IDictionary.Remove(Object)	Obsolète. Supprime l’élément avec la clé spécifiée de l’objet IDictionary. (Hérité de DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Obsolète. Retourne un énumérateur qui itère dans une collection. (Hérité de DbConnectionStringBuilder)

Méthodes d’extension

Cast<TResult>(IEnumerable)	Obsolète. Convertit les éléments d’un IEnumerable en type spécifié.
OfType<TResult>(IEnumerable)	Obsolète. Filtre les éléments d’une IEnumerable en fonction d’un type spécifié.
AsParallel(IEnumerable)	Obsolète. Active la parallélisation d’une requête.
AsQueryable(IEnumerable)	Obsolète. Convertit un IEnumerable en IQueryable.

Voir aussi

• génération de chaînes de connexion