OracleConnectionStringBuilder Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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))]
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 DbConnectionStringBuilderPublic NotInheritable Class OracleConnectionStringBuilder
Inherits DbConnectionStringBuilder- Héritage
- Attributs
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 |
| 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. |
