Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
OleDbConnectionStringBuilder, classe
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

OleDbConnectionStringBuilder, classe

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

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

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

public sealed class OleDbConnectionStringBuilder : DbConnectionStringBuilder

Le type OleDbConnectionStringBuilder expose les membres suivants.

  NomDescription
Méthode publiqueOleDbConnectionStringBuilder()Initialise une nouvelle instance de la classe OleDbConnectionStringBuilder.
Méthode publiqueOleDbConnectionStringBuilder(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.
Début

  NomDescription
Propriété publiqueBrowsableConnectionStringObtient ou définit une valeur qui indique si la propriété ConnectionString est visible dans les Concepteurs Visual Studio. (Hérité de DbConnectionStringBuilder.)
Propriété publiqueConnectionStringObtient ou définit la chaîne de connexion associée à DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder.)
Propriété publiqueCountObtient le nombre actuel des clés contenues dans la propriété ConnectionString. (Hérité de DbConnectionStringBuilder.)
Propriété publiqueDataSourceObtient ou définit le nom de la source de données à laquelle se connecter.
Propriété publiqueFileNameObtient ou définit le nom du fichier UDL (Universal Data Link) pour se connecter à la source de données.
Propriété publiqueIsFixedSizeObtient une valeur qui indique si DbConnectionStringBuilder est de taille fixe. (Hérité de DbConnectionStringBuilder.)
Propriété publiqueIsReadOnlyObtient une valeur qui indique si DbConnectionStringBuilder est en lecture seule. (Hérité de DbConnectionStringBuilder.)
Propriété publiqueItemObtient ou définit la valeur associée à la clé spécifiée. En C#, cette propriété est l'indexeur. (Substitue DbConnectionStringBuilder.Item[String].)
Propriété publiqueKeysObtient ICollection qui contient les clés de OleDbConnectionStringBuilder. (Substitue DbConnectionStringBuilder.Keys.)
Propriété publiqueOleDbServicesObtient ou définit la valeur à passer pour la clé OLE DB Services dans la chaîne de connexion.
Propriété publiquePersistSecurityInfoObtient ou définit une valeur Boolean 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é.
Propriété publiqueProviderObtient ou définit une chaîne qui contient le nom du fournisseur de données associé à la chaîne de connexion interne.
Propriété publiqueValuesObtient un objet ICollection contenant les valeurs de DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder.)
Début

  NomDescription
Méthode publiqueAddAjoute une entrée avec la clé et la valeur spécifiées dans DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder.)
Méthode publiqueClearEfface le contenu de l'instance de OleDbConnectionStringBuilder. (Substitue DbConnectionStringBuilder.Clear().)
Méthode protégéeClearPropertyDescriptorsEfface la collection d'objets PropertyDescriptor sur le DbConnectionStringBuilder associé. (Hérité de DbConnectionStringBuilder.)
Méthode publiqueContainsKeyDétermine si OleDbConnectionStringBuilder contient une clé spécifique. (Substitue DbConnectionStringBuilder.ContainsKey(String).)
Méthode publiqueEquals(Object)Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode publiqueEquivalentToCompare les informations de connexion dans cet objet DbConnectionStringBuilder avec les informations de connexion dans l'objet fourni. (Hérité de DbConnectionStringBuilder.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueGetHashCodeSert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode protégéeGetPropertiesRemplit un Hashtable fourni avec des informations sur toutes les propriétés de ce DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publiqueRemoveSupprime l'entrée contenant la clé spécifiée dans l'instance de OleDbConnectionStringBuilder. (Substitue DbConnectionStringBuilder.Remove(String).)
Méthode publiqueShouldSerializeIndique si la clé spécifiée existe dans cette instance de DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder.)
Méthode publiqueToStringRetourne la chaîne de connexion associée à ce DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder.)
Méthode publiqueTryGetValueRécupère une valeur correspondant à la clé fournie à partir de l'instance de OleDbConnectionStringBuilder. (Substitue DbConnectionStringBuilder.TryGetValue(String, Object).)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeICollection.CopyToCopie les éléments de ICollection dans Array, en commençant à un index particulier de Array. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface explicitePropriété privéeICollection.IsSynchronizedObtient une valeur indiquant si l'accès à ICollection est synchronisé (thread-safe). (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface explicitePropriété privéeICollection.SyncRootObtient un objet qui peut être utilisé pour synchroniser l'accès à ICollection. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetAttributesRetourne une collection d'attributs personnalisés pour cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetClassNameRetourne le nom de la classe de cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetComponentNameRetourne le nom de cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetConverterRetourne un convertisseur de type de cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetDefaultEventRetourne les événements par défaut pour cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetDefaultPropertyRetourne la propriété par défaut pour cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetEditorRetourne un éditeur du type spécifié pour cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetEvents()Retourne les événements correspondant à cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetEvents(Attribute[])Retourne les événements pour cette instance d'un composant à l'aide du tableau d'attributs spécifié en tant que filtre. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetProperties()Retourne les propriétés de cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetProperties(Attribute[])Retourne les propriétés pour cette instance d'un composant en utilisant le tableau d'attributs comme filtre. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetPropertyOwnerRetourne un objet qui contient la propriété décrite par le descripteur de propriété spécifié. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeIDictionary.AddAjoute un élément avec la clé et la valeur fournies à l'objet IDictionary. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeIDictionary.ContainsDétermine si l'objet IDictionary contient un élément avec la clé spécifiée. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeIDictionary.GetEnumeratorRetourne un objet IDictionaryEnumerator pour l'objet IDictionary. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface explicitePropriété privéeIDictionary.ItemObtient ou définit l'élément avec la clé spécifiée. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeIDictionary.RemoveSupprime de l'objet IDictionary l'élément ayant la clé spécifiée. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeIEnumerable.GetEnumeratorRetourne un énumérateur qui itère au sein d'une collection. (Hérité de DbConnectionStringBuilder.)
Début

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 qui correspondent 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 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 du générateur de chaînes de connexion fortement typées affiche les propriétés associées à son type et les convertisseurs qui peuvent mapper des valeurs communes pour les clés connues.

Les développeurs qui doivent 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. La classe facilite également la gestion des chaînes de connexion stockées dans un fichier de configuration de l'application. 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 valides. Le tableau suivant répertorie les clés connues et leurs propriétés correspondantes dans la classe OleDbConnectionStringBuilder, ainsi que leurs valeurs par défaut. En plus de ces valeurs spécifiques, les développeurs peuvent ajouter n'importe quelle paire clé/valeur à la collection qui est contenue dans l'instance de OleDbConnectionStringBuilder :

Clé

Property

Valeur par défaut

Nom de fichier

FileName

""

Fournisseur

Provider

""

Source de données

DataSource

""

Persist Security Info

PersistSecurityInfo

False

OLE DB Services

OleDbServices

-13

La propriété Item gère les tentatives d'insertion d'entrées malveillantes. Par exemple, le code suivant, qui utilise la propriété Item par défaut (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. L'exemple crée tout d'abord 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 également une chaîne de connexion existante et présente plusieurs façons de manipuler le contenu de la chaîne de connexion.

RemarqueRemarque

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

Pris en charge dans : 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft