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

Exemples

L’application console suivante génère des chaînes de connexion pour une base de données Oracle. Le code utilise une OracleConnectionStringBuilder classe pour créer le chaîne de connexion, puis passe la ConnectionString propriété du OracleConnectionStringBuilder instance au constructeur de la classe de connexion. L’exemple analyse également une chaîne de connexion existante et montre différentes façons de manipuler le contenu du chaîne de connexion.

Notes

Cet exemple inclut un mot de passe pour illustrer l'utilisation de OracleConnectionStringBuilder avec les chaînes de connexion. Dans vos applications, nous vous recommandons d'utiliser l'authentification Windows. Si vous devez utiliser un mot de passe, n'incluez pas de mot de passe codé en dur dans votre application.

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

Remarques

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

Les générateurs de chaîne de connexion permettent aux développeurs de créer par programmation des chaînes de connexion correctes en syntactique 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 chaîne 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 de la conception. Lorsque les développeurs utilisent le concepteur pour créer des DataSets fortement typés et des connexions fortement typées dans Visual Studio .NET, la classe de générateur fortement typée chaîne de connexion affiche les propriétés associées à son type et a également des convertisseurs qui peuvent mapper des valeurs courantes pour les clés connues.

Les développeurs ayant 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 OracleConnectionStringBuilder classe facilite également la gestion des chaînes de connexion stockées dans un fichier de configuration d’application.

OracleConnectionStringBuilder vérifie la validité des paires clé/valeur. 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 OracleConnectionStringBuilder classe conserve une collection fixe de synonymes et, si nécessaire, peut effectuer la traduction requise pour convertir d’un synonyme au nom de clé connu correspondant. Par exemple, lorsque vous utilisez la Item[] propriété pour récupérer une valeur, vous pouvez spécifier une chaîne qui contient n’importe quel synonyme pour la clé dont vous avez besoin. Pour obtenir la liste complète des synonymes acceptables, consultez la propriété Item[].

Les OracleConnectionStringBuilder handles tentent d’insérer des entrées malveillantes. Par exemple, le code suivant, à l’aide de la propriété par défaut Item[] (l’indexeur, en C#) échappe correctement la paire clé/valeur imbriquée.

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

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

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

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 spécifiée fournit les données pour les 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 le pooler 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 "User ID" et "Password" sont spécifiés dans la connexion (valeur false) ou si les informations actuelles d'identification du compte Windows sont utilisées pour l'authentification (valeur true).
IsFixedSize	Obsolète. Obtient une valeur qui indique si OracleConnectionStringBuilder est de taille fixe.
IsReadOnly	Obsolète. Obtient une valeur qui indique si l’objet 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 de OracleConnectionStringBuilder.
LoadBalanceTimeout	Obsolète. Obtient ou définit la durée de vie minimale, en secondes, de la connexion 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 transactions sur les versions précédentes 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 les informations de sécurité, telles que le mot de passe, sont retournées dans le cadre de la connexion si celle-ci est ouverte ou l'a été à un moment donné.
Pooling	Obsolète. Obtient ou définit une valeur Boolean qui indique si la connexion sera regroupée ou si chaque connexion sera ouverte explicitement chaque fois que la connexion sera demandée.
Unicode	Obsolète. Obtient ou définit une valeur Boolean qui indique si le client prend en charge la fonctionnalité Unicode disponible dans les clients Oracle ultérieurs ou non.
UserID	Obsolète. Obtient ou définit l'ID d'utilisateur à utiliser lors de la connexion à Oracle.
Values	Obsolète. Obtient un objet ICollection qui contient les valeurs de l'objet OracleConnectionStringBuilder.

Méthodes

Add(String, Object)	Obsolète. Ajoute une entrée avec la clé et la valeur spécifiées dans DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
Clear()	Obsolète. Efface le contenu de l'instance OracleConnectionStringBuilder.
ClearPropertyDescriptors()	Obsolète. Efface la collection d’objets PropertyDescriptor du DbConnectionStringBuilder associé. (Hérité de DbConnectionStringBuilder)
ContainsKey(String)	Obsolète. Détermine si 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 de cet objet DbConnectionStringBuilder avec les informations de connexion de l’objet fourni. (Hérité de DbConnectionStringBuilder)
GetHashCode()	Obsolète. Fait office 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 ce DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
GetType()	Obsolète. Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Obsolète. Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(String)	Obsolète. Supprime l'entrée contenant la clé spécifiée dans l'instance de OracleConnectionStringBuilder.
ShouldSerialize(String)	Obsolète. Indique si la clé spécifiée existe dans cette instance de OracleConnectionStringBuilder.
ToString()	Obsolète. Retourne la chaîne de connexion associée à ce DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
TryGetValue(String, Object)	Obsolète. Récupère une valeur correspondant à la clé fournie à partir de cet objet OracleConnectionStringBuilder.

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)	Obsolète. Copie les éléments de ICollection dans Array, à partir d'un index particulier de Array. (Hérité de DbConnectionStringBuilder)
ICollection.IsSynchronized	Obsolète. Obtient une valeur indiquant si l’accès à 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 à 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 pour cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Obsolète. Retourne les événements pour cette instance d’un composant à l’aide du tableau d’attributs spécifié comme filtre. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Obsolète. Retourne les propriétés pour 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 comme 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 à l'aide de la clé spécifiée. (Hérité de DbConnectionStringBuilder)
IDictionary.Remove(Object)	Obsolète. Supprime de l’objet IDictionary l’élément ayant la clé spécifiée. (Hérité de DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Obsolète. Retourne un énumérateur qui itère au sein d’une collection. (Hérité de DbConnectionStringBuilder)

Méthodes d’extension

Cast<TResult>(IEnumerable)	Obsolète. Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Obsolète. Filtre les éléments d'un IEnumerable en fonction du 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

• Création de chaînes de connexion