Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

OleDbConnectionStringBuilder classe

 

Date de publication : novembre 2016

Fournit un moyen simple de créer et de gérer le contenu de chaînes de connexion utilisées par la classe OleDbConnection.

Espace de noms:   System.Data.OleDb
Assembly:  System.Data (dans System.Data.dll)

System.Object
  System.Data.Common.DbConnectionStringBuilder
    System.Data.OleDb.OleDbConnectionStringBuilder

public sealed class OleDbConnectionStringBuilder : DbConnectionStringBuilder

NomDescription
System_CAPS_pubmethodOleDbConnectionStringBuilder()

Initialise une nouvelle instance de la classe OleDbConnectionStringBuilder.

System_CAPS_pubmethodOleDbConnectionStringBuilder(String)

Initialise une nouvelle instance de la classe OleDbConnectionStringBuilder. La chaîne de connexion spécifiée fournit les données pour les informations de connexion internes de l'instance.

NomDescription
System_CAPS_pubpropertyBrowsableConnectionString

Obtient ou définit une valeur qui indique si la propriété ConnectionString est visible dans les concepteurs Visual Studio.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubpropertyConnectionString

Obtient ou définit la chaîne de connexion associée au DbConnectionStringBuilder.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubpropertyCount

Obtient le nombre actuel de clés contenues dans la propriété ConnectionString.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubpropertyDataSource

Obtient ou définit le nom de la source de données pour se connecter à.

System_CAPS_pubpropertyFileName

Obtient ou définit le nom du fichier de lien de données universel (UDL) pour la connexion à la source de données.

System_CAPS_pubpropertyIsFixedSize

Obtient une valeur qui indique si DbConnectionStringBuilder est de taille fixe.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubpropertyIsReadOnly

Obtient une valeur qui indique si l'objet DbConnectionStringBuilder est en lecture seule.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubpropertyItem[String]

Obtient ou définit la valeur associée à la clé spécifiée. En C#, cette propriété est l'indexeur.(Remplace DbConnectionStringBuilder.Item[String].)

System_CAPS_pubpropertyKeys

Obtient un ICollection qui contient les clés de OleDbConnectionStringBuilder.(Remplace DbConnectionStringBuilder.Keys.)

System_CAPS_pubpropertyOleDbServices

Obtient ou définit la valeur à passer pour la clé OLE DB Services dans la chaîne de connexion.

System_CAPS_pubpropertyPersistSecurityInfo

Obtient ou définit une valeur booléenne qui indique si les informations de sécurité sensibles, telles que le mot de passe, sont retournées dans le cadre de la connexion si la connexion est ouverte ou l’a jamais été en état ouvert.

System_CAPS_pubpropertyProvider

Obtient ou définit une chaîne qui contient le nom du fournisseur de données associé à la chaîne de connexion interne.

System_CAPS_pubpropertyValues

Obtient un objet ICollection qui contient les valeurs de l'objet DbConnectionStringBuilder.(Hérité de DbConnectionStringBuilder.)

NomDescription
System_CAPS_pubmethodAdd(String, Object)

Ajoute une entrée avec la clé et la valeur spécifiées dans DbConnectionStringBuilder.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubmethodClear()

Efface le contenu de l'instance OleDbConnectionStringBuilder.(Remplace DbConnectionStringBuilder.Clear().)

System_CAPS_protmethodClearPropertyDescriptors()

Efface la collection d’objets PropertyDescriptor du DbConnectionStringBuilder associé.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubmethodContainsKey(String)

Détermine si OleDbConnectionStringBuilder contient une clé spécifique.(Remplace DbConnectionStringBuilder.ContainsKey(String).)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodEquivalentTo(DbConnectionStringBuilder)

Compare les informations de connexion de cet objet DbConnectionStringBuilder avec les informations de connexion de l’objet fourni.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodRemove(String)

Supprime l'entrée contenant la clé spécifiée dans l'instance de OleDbConnectionStringBuilder.(Remplace DbConnectionStringBuilder.Remove(String).)

System_CAPS_pubmethodShouldSerialize(String)

Indique si la clé spécifiée existe dans cette instance de DbConnectionStringBuilder.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubmethodToString()

Retourne la chaîne de connexion associée à ce DbConnectionStringBuilder.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubmethodTryGetValue(String, Object)

Récupère une valeur correspondant à la clé fournie à partir de la OleDbConnectionStringBuilder instance.(Remplace DbConnectionStringBuilder.TryGetValue(String, Object).)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodICollection.CopyTo(Array, Int32)

Copie les éléments de ICollection dans Array, à partir d'un index particulier de Array.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDictionary.Add(Object, Object)

Ajoute un élément avec la clé et la valeur fournies à l'objet IDictionary.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDictionary.Contains(Object)

Détermine si l'objet IDictionary contient un élément avec la clé spécifiée.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDictionary.GetEnumerator()

Retourne un objet IDictionaryEnumerator pour l’objet IDictionary.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDictionary.Remove(Object)

Supprime de l’objet IDictionary l’élément ayant la clé spécifiée.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIEnumerable.GetEnumerator()

Retourne un énumérateur qui itère au sein d'une collection.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetAttributes()

Retourne une collection d’attributs personnalisés pour cette instance d’un composant.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetClassName()

Retourne le nom de classe de cette instance d’un composant.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetComponentName()

Retourne le nom de cette instance d’un composant.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetConverter()

Retourne un convertisseur de type pour cette instance d’un composant.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetDefaultEvent()

Retourne l’événement par défaut pour cette instance d’un composant.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetDefaultProperty()

Retourne la propriété par défaut pour cette instance d’un composant.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetEditor(Type)

Retourne un éditeur du type spécifié pour cette instance d’un composant.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetEvents()

Retourne les événements pour cette instance d’un composant.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetEvents(Attribute[])

Retourne les événements pour cette instance d’un composant à l’aide du tableau d’attributs spécifié comme filtre.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetProperties()

Retourne les propriétés pour cette instance d’un composant.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetProperties(Attribute[])

Retourne les propriétés de cette instance d’un composant à l’aide du tableau d’attributs comme filtre.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)

Retourne un objet qui contient la propriété décrite par le descripteur de propriété spécifié.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.IsSynchronized

Obtient une valeur indiquant si l'accès à ICollection est synchronisé (thread-safe).(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l'accès à ICollection.(Hérité de DbConnectionStringBuilder.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDictionary.Item[Object]

Obtient ou définit l'élément à l'aide de la clé spécifiée.(Hérité de DbConnectionStringBuilder.)

NomDescription
System_CAPS_pubmethodAsParallel()

Surchargé. Active la parallélisation d'une requête.(Défini par ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Surchargé. Convertit un IEnumerable à un IQueryable.(Défini par Queryable.)

System_CAPS_pubmethodCast<TResult>()

Convertit les éléments d’un IEnumerable au type spécifié.(Défini par Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtre les éléments d’un IEnumerable basé sur un type spécifié.(Défini par Enumerable.)

Le générateur de chaînes de connexion permet aux développeurs de créer par programme des chaînes de connexion correctes du point de vue de la syntaxe, et d'analyser et régénérer 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 les connexions OLE DB, et les développeurs peuvent ajouter des paires clé/valeur arbitraires pour toute autre valeur de chaîne de connexion. La classe OleDbConnectionStringBuilder implémente l'interface ICustomTypeDescriptor. Cela signifie que la classe fonctionne avec les concepteurs de 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 dans Visual Studio .NET, la classe de générateur de chaînes de connexion fortement typées 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 ayant besoin de créer des chaînes de connexion dans le cadre d'applications peuvent utiliser la classe OleDbConnectionStringBuilder pour générer et modifier des chaînes de connexion. Cette classe permet également de gérer facilement les chaînes de connexion stockées dans un fichier de configuration de l'application. Le OleDbConnectionStringBuilder effectue des vérifications uniquement pour le jeu limité de paires clé/valeur connues. Par conséquent, cette classe peut être utilisée pour créer des chaînes de connexion non valide. Le tableau suivant répertorie les clés connues et leurs propriétés correspondantes dans la OleDbConnectionStringBuilder classe et leurs valeurs par défaut. En plus de ces valeurs spécifiques, les développeurs peuvent ajouter des paires clé/valeur à la collection qui est contenue dans le OleDbConnectionStringBuilder instance :

Clé

Property

Valeur par défaut

Nom de fichier

FileName

""

Fournisseur

Provider

""

Source de données

DataSource

""

Persist Security Info

PersistSecurityInfo

False

Services OLE DB

OleDbServices

-13

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

System.Data.OleDb.OleDbConnectionStringBuilder builder = 
    new System.Data.OleDb.OleDbConnectionStringBuilder();
builder["Provider"] = "Microsoft.Jet.OLEDB.4.0";
builder["Data Source"] = "C:\\Sample.mdb";
builder["User Id"] = "Admin;NewValue=Bad";

Le résultat est la chaîne de connexion suivante qui gère la valeur non valide de manière sécurisée.

Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Sample.mdb;User ID="Admin;NewValue=Bad"

L’application console suivante génère des chaînes de connexion pour plusieurs bases de données OLE DB. Tout d’abord, l’exemple crée une chaîne de connexion pour une base de données Microsoft Access, puis crée une chaîne de connexion pour une base de données IBM DB2. L’exemple analyse une chaîne de connexion existante et présente plusieurs façons de manipuler le contenu de la chaîne de connexion.

System_CAPS_noteRemarque

Cet exemple inclut un mot de passe pour illustrer l'utilisation de OleDbConnectionStringBuilder 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.

using System.Data.OleDb;

class Program
{
    static void Main(string[] args)
    {
        OleDbConnectionStringBuilder builder = new OleDbConnectionStringBuilder();
        builder.ConnectionString = @"Data Source=C:\Sample.mdb";

        // Call the Add method to explicitly add key/value
        // pairs to the internal collection.
        builder.Add("Provider", "Microsoft.Jet.Oledb.4.0");
        builder.Add("Jet OLEDB:Database Password", "MyPassword!");
        builder.Add("Jet OLEDB:System Database", @"C:\Workgroup.mdb");

        // Set up row-level locking.
        builder.Add("Jet OLEDB:Database Locking Mode", 1);

        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();

        // Clear current values and reset known keys to their
        // default values.
        builder.Clear();

        // Pass the OleDbConnectionStringBuilder an existing 
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString =
            "Provider=DB2OLEDB;Network Transport Library=TCPIP;" +
            "Network Address=192.168.0.12;Initial Catalog=DbAdventures;" +
            "Package Collection=SamplePackage;Default Schema=SampleSchema;";

        Console.WriteLine("Network Address = " + builder["Network Address"].ToString());
        Console.WriteLine();

        // Modify existing items.
        builder["Package Collection"] = "NewPackage";
        builder["Default Schema"] = "NewSchema";

        // Call the Remove method to remove items from 
        // the collection of key/value pairs.
        builder.Remove("User ID");

        // Note that calling Remove on a nonexistent item does not
        // throw an exception.
        builder.Remove("BadItem");
        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();

        // Setting the indexer adds the value, if 
        // necessary.
        builder["User ID"] = "SampleUser";
        builder["Password"] = "SamplePassword";
        Console.WriteLine(builder.ConnectionString);

        Console.WriteLine("Press Enter to finish.");
        Console.ReadLine();
    }
}

.NET Framework
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: