SqlConnectionStringBuilder SqlConnectionStringBuilder SqlConnectionStringBuilder SqlConnectionStringBuilder Class

Définition

Fournit un moyen simple de créer et de gérer le contenu de chaînes de connexion utilisées par la classe SqlConnection.Provides a simple way to create and manage the contents of connection strings used by the SqlConnection class.

public ref class SqlConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder
[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlConnectionStringBuilder/SqlConnectionStringBuilderConverter))]
public sealed class SqlConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder
type SqlConnectionStringBuilder = class
    inherit DbConnectionStringBuilder
Public NotInheritable Class SqlConnectionStringBuilder
Inherits DbConnectionStringBuilder
Héritage
SqlConnectionStringBuilderSqlConnectionStringBuilderSqlConnectionStringBuilderSqlConnectionStringBuilder
Attributs

Exemples

L’application console suivante génère des chaînes de connexion pour une base de données SQL Server.The following console application builds connection strings for a SQL Server database. Le code utilise une classe SqlConnectionStringBuilder pour créer la chaîne de connexion, puis passe la propriété ConnectionString de l'instance de SqlConnectionStringBuilder au constructeur de la classe de connexion.The code uses a SqlConnectionStringBuilder class to create the connection string, and then passes the ConnectionString property of the SqlConnectionStringBuilder instance to the constructor of the connection class. 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.The example also parses an existing connection string and demonstrates various ways of manipulating the connection string's contents.

Notes

Cet exemple inclut un mot de passe pour illustrer l'utilisation de SqlConnectionStringBuilder avec les chaînes de connexion.This example includes a password to demonstrate how SqlConnectionStringBuilder works with connection strings. Dans vos applications, nous vous recommandons d'utiliser l'authentification Windows.In your applications, we recommend that you use Windows Authentication. Si vous devez utiliser un mot de passe, n'incluez pas de mot de passe codé en dur dans votre application.If you must use a password, do not include a hard-coded password in your application.

using System.Data;
using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        // Create a new SqlConnectionStringBuilder and
        // initialize it with a few name/value pairs.
        SqlConnectionStringBuilder builder =
            new SqlConnectionStringBuilder(GetConnectionString());

        // 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 SqlConnectionStringBuilder an existing 
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString = "server=(local);user id=ab;" +
            "password= a!Pass113;initial catalog=AdventureWorks";

        // Now that the connection string has been parsed,
        // you can work with individual items.
        Console.WriteLine(builder.Password);
        builder.Password = "new@1Password";
        builder.AsynchronousProcessing = 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["Connect Timeout"] = 1000;
        builder["Trusted_Connection"] = 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=(local);Integrated Security=SSPI;" +
            "Initial Catalog=AdventureWorks";
    }
}
Imports System.Data.SqlClient

Module Module1
    Sub Main()
        ' Create a new SqlConnectionStringBuilder and
        ' initialize it with a few name/value pairs:
        Dim builder As New SqlConnectionStringBuilder(GetConnectionString())

        ' 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 SqlConnectionStringBuilder an existing 
        ' connection string, and you can retrieve and
        ' modify any of the elements.
        builder.ConnectionString = _
            "server=(local);user id=ab;" & _
            "password=a!Pass113;initial catalog=AdventureWorks"
        ' Now that the connection string has been parsed,
        ' you can work with individual items.
        Console.WriteLine(builder.Password)
        builder.Password = "new@1Password"
        builder.AsynchronousProcessing = 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("Connect 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("Trusted_Connection") = 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=(local);Integrated Security=SSPI;" & _
          "Initial Catalog=AdventureWorks"
    End Function
End Module

Remarques

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.The connection string builder lets developers programmatically create syntactically correct connection strings, and parse and rebuild existing connection strings, using properties and methods of the class. 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 SQL Server.The connection string builder provides strongly typed properties corresponding to the known key/value pairs allowed by SQL Server. Les développeurs ayant besoin de créer des chaînes de connexion dans le cadre d'applications peuvent utiliser la classe SqlConnectionStringBuilder pour générer et modifier des chaînes de connexion.Developers needing to create connection strings as part of applications can use the SqlConnectionStringBuilder class to build and modify connection strings. Cette classe permet également de gérer facilement les chaînes de connexion stockées dans un fichier de configuration de l'application.The class also makes it easy to manage connection strings stored in an application configuration file.

SqlConnectionStringBuilder vérifie la validité des paires clé/valeur.The SqlConnectionStringBuilder performs checks for valid key/value pairs. Par conséquent, il n'est pas possible d'utiliser cette classe pour créer des chaînes de connexion non valides ; toute tentative d'ajout de paires non valides lève une exception.Therefore, you cannot use this class to create invalid connection strings; trying to add invalid pairs will throw an exception. La classe maintient une collection fixe de synonymes et peut traduire un synonyme vers le nom de la clé connue correspondante.The class maintains a fixed collection of synonyms and can translate from a synonym to the corresponding well-known key name.

Par exemple, lorsque vous utilisez la propriété Item pour récupérer une valeur, vous pouvez spécifier une chaîne qui contient un synonyme pour la clé dont vous avez besoin.For example, when you use the Item property to retrieve a value, you can specify a string that contains any synonym for the key you need. Par exemple, vous pouvez spécifier « adresse réseau », « addr » ou tout autre synonyme acceptable pour cette clé dans une chaîne de connexion lorsque vous utilisez un membre qui requiert une chaîne qui contient le nom de clé, tel que **** la propriété d’élément Remove ou la méthode.For example, you can specify "Network Address", "addr", or any other acceptable synonym for this key within a connection string when you use any member that requires a string that contains the key name, such as the Item property or the Remove method. Pour obtenir la liste complète des synonymes acceptables, consultez la propriété ConnectionString.See the ConnectionString property for a full list of acceptable synonyms.

La propriété Item gère les tentatives d’insertion d’entrées malveillantes.The Item property handles tries to insert malicious entries. 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 :For example, the following code, using the default Item property (the indexer, in C#) correctly escapes the nested key/value pair:

Dim builder As New System.Data.SqlClient.SqlConnectionStringBuilder  
builder("Data Source") = "(local)"  
builder("Integrated Security") = True  
builder("Initial Catalog") = "AdventureWorks;NewValue=Bad"  
Console.WriteLine(builder.ConnectionString)  
System.Data.SqlClient.SqlConnectionStringBuilder builder =  
  new System.Data.SqlClient.SqlConnectionStringBuilder();  
builder["Data Source"] = "(local)";  
builder["integrated Security"] = true;  
builder["Initial Catalog"] = "AdventureWorks;NewValue=Bad";  
Console.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.The result is the following connection string that handles the invalid value in a safe manner:

Source=(local);Initial Catalog="AdventureWorks;NewValue=Bad";  
Integrated Security=True  

Constructeurs

SqlConnectionStringBuilder() SqlConnectionStringBuilder() SqlConnectionStringBuilder() SqlConnectionStringBuilder()

Initialise une nouvelle instance de la classe SqlConnectionStringBuilder.Initializes a new instance of the SqlConnectionStringBuilder class.

SqlConnectionStringBuilder(String) SqlConnectionStringBuilder(String) SqlConnectionStringBuilder(String) SqlConnectionStringBuilder(String)

Initialise une nouvelle instance de la classe SqlConnectionStringBuilder.Initializes a new instance of the SqlConnectionStringBuilder class. La chaîne de connexion spécifiée fournit les données pour les informations de connexion internes de l'instance.The provided connection string provides the data for the instance's internal connection information.

Propriétés

ApplicationIntent ApplicationIntent ApplicationIntent ApplicationIntent

Déclare le type de charge de travail de l'application lors de la connexion à une base de données dans un groupe de disponibilité SQL Server.Declares the application workload type when connecting to a database in an SQL Server Availability Group. Vous pouvez affecter à cette propriété la valeur ApplicationIntent.You can set the value of this property with ApplicationIntent. Pour plus d’informations sur la prise en charge de SqlClient pour les groupes de disponibilité AlwaysOn, consultez Prise en charge de SqlClient pour la haute disponibilité et la récupération d’urgence.For more information about SqlClient support for Always On Availability Groups, see SqlClient Support for High Availability, Disaster Recovery.

ApplicationName ApplicationName ApplicationName ApplicationName

Obtient ou définit le nom de l'application associée à la chaîne de connexion.Gets or sets the name of the application associated with the connection string.

AsynchronousProcessing AsynchronousProcessing AsynchronousProcessing AsynchronousProcessing

Obtient ou définit une valeur booléenne qui indique si le traitement asynchrone est autorisé par la connexion créée à l'aide de cette chaîne de connexion.Gets or sets a Boolean value that indicates whether asynchronous processing is allowed by the connection created by using this connection string.

AttachDBFilename AttachDBFilename AttachDBFilename AttachDBFilename

Obtient ou définit une chaîne qui contient le nom du fichier de données principal.Gets or sets a string that contains the name of the primary data file. Cela inclut le nom du chemin d'accès complet d'une base de données pouvant être attachée.This includes the full path name of an attachable database.

Authentication Authentication Authentication Authentication

Obtient l’authentification de la chaîne de connexion.Gets the authentication of the connection string.

BrowsableConnectionString BrowsableConnectionString BrowsableConnectionString BrowsableConnectionString

Obtient ou définit une valeur qui indique si la propriété ConnectionString est visible dans les concepteurs Visual Studio.Gets or sets a value that indicates whether the ConnectionString property is visible in Visual Studio designers.

(Inherited from DbConnectionStringBuilder)
ColumnEncryptionSetting ColumnEncryptionSetting ColumnEncryptionSetting ColumnEncryptionSetting

Obtient ou définit les paramètres de chiffrement de colonne pour le générateur de chaînes de connexion.Gets or sets the column encryption settings for the connection string builder.

ConnectionReset ConnectionReset ConnectionReset ConnectionReset

Obsolète.Obsolete. Obtient ou définit une valeur booléenne qui indique si la connexion est réinitialisée lorsqu'elle est récupérée du pool de connexions.Gets or sets a Boolean value that indicates whether the connection is reset when drawn from the connection pool.

ConnectionString ConnectionString ConnectionString ConnectionString

Obtient ou définit la chaîne de connexion associée au DbConnectionStringBuilder.Gets or sets the connection string associated with the DbConnectionStringBuilder.

(Inherited from DbConnectionStringBuilder)
ConnectRetryCount ConnectRetryCount ConnectRetryCount ConnectRetryCount

Nombre de tentatives de reconnexion après l’identification de l’échec de connexion inactive.The number of reconnections attempted after identifying that there was an idle connection failure. La valeur doit être un entier compris entre 0 et 255.This must be an integer between 0 and 255. La valeur par défaut est 1.Default is 1. Définissez la valeur sur 0 pour désactiver la reconnexion en cas d’échec de connexion inactive.Set to 0 to disable reconnecting on idle connection failures. Une ArgumentException est levée si la valeur n’appartient pas à la plage autorisée.An ArgumentException will be thrown if set to a value outside of the allowed range.

ConnectRetryInterval ConnectRetryInterval ConnectRetryInterval ConnectRetryInterval

Durée (en secondes) entre chaque tentative de reconnexion après identification d’un échec de connexion inactive.Amount of time (in seconds) between each reconnection attempt after identifying that there was an idle connection failure. La valeur doit être un entier compris entre 1 et 60.This must be an integer between 1 and 60. La valeur par défaut est 10 secondes.The default is 10 seconds. Une ArgumentException est levée si la valeur n’appartient pas à la plage autorisée.An ArgumentException will be thrown if set to a value outside of the allowed range.

ConnectTimeout ConnectTimeout ConnectTimeout ConnectTimeout

Obtient ou définit la durée d'attente (en secondes) préalable à l'établissement d'une connexion au serveur avant que la tentative ne soit abandonnée et qu'une erreur ne soit générée.Gets or sets the length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error.

ContextConnection ContextConnection ContextConnection ContextConnection

Obtient ou définit une valeur qui indique si une connexion client/serveur ou in-process à SQL Server doit être établie.Gets or sets a value that indicates whether a client/server or in-process connection to SQL Server should be made.

Count Count Count Count

Obtient le nombre actuel de clés contenues dans la propriété ConnectionString.Gets the current number of keys that are contained within the ConnectionString property.

(Inherited from DbConnectionStringBuilder)
CurrentLanguage CurrentLanguage CurrentLanguage CurrentLanguage

Obtient ou définit le nom d'enregistrement du langage SQL Server.Gets or sets the SQL Server Language record name.

DataSource DataSource DataSource DataSource

Obtient ou définit le nom ou l'adresse réseau de l'instance de SQL Server à laquelle se connecter.Gets or sets the name or network address of the instance of SQL Server to connect to.

EnclaveAttestationUrl EnclaveAttestationUrl EnclaveAttestationUrl EnclaveAttestationUrl

Obtient ou définit l’URL d’attestation d’enclave à utiliser avec Always Encrypted basé sur l’enclave.Gets or sets the enclave attestation Url to be used with enclave based Always Encrypted.

Encrypt Encrypt Encrypt Encrypt

Obtient ou définit une valeur booléenne qui indique si SQL Server utilise le chiffrement SSL pour tous les échanges de données se produisant entre le client et le serveur si celui-ci dispose d'un certificat installé.Gets or sets a Boolean value that indicates whether SQL Server uses SSL encryption for all data sent between the client and server if the server has a certificate installed.

Enlist Enlist Enlist Enlist

Obtient ou définit une valeur booléenne qui indique si le pooler de connexion SQL Server inscrit automatiquement la connexion dans le contexte de transaction actuel du thread de création.Gets or sets a Boolean value that indicates whether the SQL Server connection pooler automatically enlists the connection in the creation thread's current transaction context.

FailoverPartner FailoverPartner FailoverPartner FailoverPartner

Obtient ou définit le nom ou l'adresse du serveur partenaire auquel se connecter si le serveur principal est en panne.Gets or sets the name or address of the partner server to connect to if the primary server is down.

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Obtient une valeur indiquant si l'accès à ICollection est synchronisé (thread-safe).Gets a value indicating whether access to the ICollection is synchronized (thread safe).

(Inherited from DbConnectionStringBuilder)
ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l'accès à ICollection.Gets an object that can be used to synchronize access to the ICollection.

(Inherited from DbConnectionStringBuilder)
IDictionary.IsFixedSize IDictionary.IsFixedSize IDictionary.IsFixedSize IDictionary.IsFixedSize Inherited from DbConnectionStringBuilder
IDictionary.IsReadOnly IDictionary.IsReadOnly IDictionary.IsReadOnly IDictionary.IsReadOnly Inherited from DbConnectionStringBuilder
IDictionary.Item[Object] IDictionary.Item[Object] IDictionary.Item[Object] IDictionary.Item[Object]

Obtient ou définit l'élément à l'aide de la clé spécifiée.Gets or sets the element with the specified key.

(Inherited from DbConnectionStringBuilder)
InitialCatalog InitialCatalog InitialCatalog InitialCatalog

Obtient ou définit le nom de la base de données associée à la connexion.Gets or sets the name of the database associated with the connection.

IntegratedSecurity IntegratedSecurity IntegratedSecurity IntegratedSecurity

Obtient ou définit une valeur booléenne qui indique si l’ID d’utilisateur et le mot de passe sont spécifiés dans la connexion (quand false) ou si les informations actuelles d’identification du compte Windows sont utilisées pour l’authentification (quand true).Gets or sets a Boolean value that indicates whether User ID and Password are specified in the connection (when false) or whether the current Windows account credentials are used for authentication (when true).

IsFixedSize IsFixedSize IsFixedSize IsFixedSize

Obtient une valeur qui indique si SqlConnectionStringBuilder est de taille fixe.Gets a value that indicates whether the SqlConnectionStringBuilder has a fixed size.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Obtient une valeur qui indique si l'objet DbConnectionStringBuilder est en lecture seule.Gets a value that indicates whether the DbConnectionStringBuilder is read-only.

(Inherited from DbConnectionStringBuilder)
Item[String] Item[String] Item[String] Item[String]

Obtient ou définit la valeur associée à la clé spécifiée.Gets or sets the value associated with the specified key. En C#, cette propriété est l'indexeur.In C#, this property is the indexer.

Keys Keys Keys Keys

Obtient un ICollection qui contient les clés de SqlConnectionStringBuilder.Gets an ICollection that contains the keys in the SqlConnectionStringBuilder.

LoadBalanceTimeout LoadBalanceTimeout LoadBalanceTimeout LoadBalanceTimeout

Obtient ou définit la durée de vie minimale, en secondes, de la connexion dans le pool de connexions avant sa destruction.Gets or sets the minimum time, in seconds, for the connection to live in the connection pool before being destroyed.

MaxPoolSize MaxPoolSize MaxPoolSize MaxPoolSize

Obtient ou définit le nombre maximal de connexions autorisées dans le pool de connexions pour cette chaîne de connexion spécifique.Gets or sets the maximum number of connections allowed in the connection pool for this specific connection string.

MinPoolSize MinPoolSize MinPoolSize MinPoolSize

Obtient ou définit le nombre minimal de connexions autorisées dans le pool de connexions pour cette chaîne de connexion spécifique.Gets or sets the minimum number of connections allowed in the connection pool for this specific connection string.

MultipleActiveResultSets MultipleActiveResultSets MultipleActiveResultSets MultipleActiveResultSets

Si la valeur est true, une application peut conserver plusieurs jeux MARS (Multiple Active Result Sets).When true, an application can maintain multiple active result sets (MARS). Si la valeur est false, une application doit traiter ou annuler tous les jeux de résultats d’un lot avant de pouvoir exécuter un autre lot sur cette connexion.When false, an application must process or cancel all result sets from one batch before it can execute any other batch on that connection.

Pour plus d’informations, consultez MARS (Multiple Active Result Sets).For more information, see Multiple Active Result Sets (MARS).

MultiSubnetFailover MultiSubnetFailover MultiSubnetFailover MultiSubnetFailover

Si votre application se connecte à un groupe de disponibilité AlwaysOn sur des sous-réseaux différents, le paramétrage MultiSubnetFailover=true permet de détecter et de se connecter plus rapidement au serveur actif.If your application is connecting to an AlwaysOn availability group (AG) on different subnets, setting MultiSubnetFailover=true provides faster detection of and connection to the (currently) active server. Pour plus d’informations sur la prise en charge de SqlClient pour les groupes de disponibilité AlwaysOn, consultez Prise en charge de SqlClient pour la haute disponibilité et la récupération d’urgence.For more information about SqlClient support for Always On Availability Groups, see SqlClient Support for High Availability, Disaster Recovery.

NetworkLibrary NetworkLibrary NetworkLibrary NetworkLibrary

Obtient ou définit une chaîne qui contient le nom de la bibliothèque réseau utilisée pour établir une connexion à SQL Server.Gets or sets a string that contains the name of the network library used to establish a connection to the SQL Server.

PacketSize PacketSize PacketSize PacketSize

Obtient ou définit la taille en octets des paquets réseau permettant de communiquer avec une instance de SQL Server.Gets or sets the size in bytes of the network packets used to communicate with an instance of SQL Server.

Password Password Password Password

Obtient ou définit le mot de passe du compte SQL Server.Gets or sets the password for the SQL Server account.

PersistSecurityInfo PersistSecurityInfo PersistSecurityInfo PersistSecurityInfo

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é.Gets or sets a Boolean value that indicates if security-sensitive information, such as the password, is not returned as part of the connection if the connection is open or has ever been in an open state.

PoolBlockingPeriod PoolBlockingPeriod PoolBlockingPeriod PoolBlockingPeriod

Comportement de la période de blocage d'un pool de connexions.The blocking period behavior for a connection pool.

Pooling Pooling Pooling Pooling

Obtient ou définit une valeur booléenne qui indique si la connexion sera regroupée ou ouverte explicitement chaque fois que la connexion est demandée.Gets or sets a Boolean value that indicates whether the connection will be pooled or explicitly opened every time that the connection is requested.

Replication Replication Replication Replication

Obtient ou définit une valeur booléenne qui indique si la réplication est prise en charge avec la connexion.Gets or sets a Boolean value that indicates whether replication is supported using the connection.

TransactionBinding TransactionBinding TransactionBinding TransactionBinding

Obtient ou définit une valeur de chaîne indiquant comment la connexion continue d’être associée à la transaction System.Transactions inscrite.Gets or sets a string value that indicates how the connection maintains its association with an enlisted System.Transactions transaction.

TransparentNetworkIPResolution TransparentNetworkIPResolution TransparentNetworkIPResolution TransparentNetworkIPResolution

Lorsque la valeur de cette clé est définie sur true, l’application doit récupérer toutes les adresses IP pour une entrée DNS spécifique et essayer de se connecter à la première dans la liste.When the value of this key is set to true, the application is required to retrieve all IP addresses for a particular DNS entry and attempt to connect with the first one in the list. Si la connexion n’est pas établie dans un délai de 0,5 seconde, l’application tente de se connecter à toutes les autres en parallèle.If the connection is not established within 0.5 seconds, the application will try to connect to all others in parallel. Lorsque la première répond, l’application établit une connexion avec l’adresse IP qui répond.When the first answers, the application will establish the connection with the respondent IP address.

TrustServerCertificate TrustServerCertificate TrustServerCertificate TrustServerCertificate

Obtient ou définit une valeur qui indique si le canal sera chiffré dans le cas où l'approbation de la chaîne de certificats est ignorée.Gets or sets a value that indicates whether the channel will be encrypted while bypassing walking the certificate chain to validate trust.

TypeSystemVersion TypeSystemVersion TypeSystemVersion TypeSystemVersion

Obtient ou définit une valeur de chaîne qui indique le système de type que l'application attend.Gets or sets a string value that indicates the type system the application expects.

UserID UserID UserID UserID

Obtient ou définit l'ID d'utilisateur à utiliser lors de la connexion à SQL Server.Gets or sets the user ID to be used when connecting to SQL Server.

UserInstance UserInstance UserInstance UserInstance

Obtient ou définit une valeur qui indique s'il faut rediriger la connexion de l'instance de SQL Server Express par défaut vers une instance lancée à l'exécution qui s'exécute sous le compte de l'appelant.Gets or sets a value that indicates whether to redirect the connection from the default SQL Server Express instance to a runtime-initiated instance running under the account of the caller.

Values Values Values Values

Obtient un objet ICollection qui contient les valeurs de l'objet SqlConnectionStringBuilder.Gets an ICollection that contains the values in the SqlConnectionStringBuilder.

WorkstationID WorkstationID WorkstationID WorkstationID

Obtient ou définit le nom de la station de travail se connectant à SQL Server.Gets or sets the name of the workstation connecting to SQL Server.

Méthodes

Add(String, Object) Add(String, Object) Add(String, Object) Add(String, Object)

Ajoute une entrée avec la clé et la valeur spécifiées dans DbConnectionStringBuilder.Adds an entry with the specified key and value into the DbConnectionStringBuilder.

(Inherited from DbConnectionStringBuilder)
Clear() Clear() Clear() Clear()

Efface le contenu de l'instance SqlConnectionStringBuilder.Clears the contents of the SqlConnectionStringBuilder instance.

ClearPropertyDescriptors() ClearPropertyDescriptors() ClearPropertyDescriptors() ClearPropertyDescriptors()

Efface la collection d’objets PropertyDescriptor du DbConnectionStringBuilder associé.Clears the collection of PropertyDescriptor objects on the associated DbConnectionStringBuilder.

(Inherited from DbConnectionStringBuilder)
ContainsKey(String) ContainsKey(String) ContainsKey(String) ContainsKey(String)

Détermine si SqlConnectionStringBuilder contient une clé spécifique.Determines whether the SqlConnectionStringBuilder contains a specific key.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
EquivalentTo(DbConnectionStringBuilder) EquivalentTo(DbConnectionStringBuilder) EquivalentTo(DbConnectionStringBuilder) EquivalentTo(DbConnectionStringBuilder)

Compare les informations de connexion de cet objet DbConnectionStringBuilder avec les informations de connexion de l’objet fourni.Compares the connection information in this DbConnectionStringBuilder object with the connection information in the supplied object.

(Inherited from DbConnectionStringBuilder)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetProperties(Hashtable) GetProperties(Hashtable) GetProperties(Hashtable) GetProperties(Hashtable)

Remplit un Hashtable fourni avec des informations sur toutes les propriétés de ce DbConnectionStringBuilder.Fills a supplied Hashtable with information about all the properties of this DbConnectionStringBuilder.

(Inherited from DbConnectionStringBuilder)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(String) Remove(String) Remove(String) Remove(String)

Supprime l'entrée contenant la clé spécifiée dans l'instance de SqlConnectionStringBuilder.Removes the entry with the specified key from the SqlConnectionStringBuilder instance.

ShouldSerialize(String) ShouldSerialize(String) ShouldSerialize(String) ShouldSerialize(String)

Indique si la clé spécifiée existe dans cette instance de SqlConnectionStringBuilder.Indicates whether the specified key exists in this SqlConnectionStringBuilder instance.

ToString() ToString() ToString() ToString()

Retourne la chaîne de connexion associée à ce DbConnectionStringBuilder.Returns the connection string associated with this DbConnectionStringBuilder.

(Inherited from DbConnectionStringBuilder)
TryGetValue(String, Object) TryGetValue(String, Object) TryGetValue(String, Object) TryGetValue(String, Object)

Récupère une valeur correspondant à la clé fournie à partir de cet objet SqlConnectionStringBuilder.Retrieves a value corresponding to the supplied key from this SqlConnectionStringBuilder.

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Copie les éléments de ICollection dans Array, à partir d'un index particulier de Array.Copies the elements of the ICollection to an Array, starting at a particular Array index.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes() ICustomTypeDescriptor.GetAttributes() ICustomTypeDescriptor.GetAttributes() ICustomTypeDescriptor.GetAttributes()

Retourne une collection d’attributs personnalisés pour cette instance d’un composant.Returns a collection of custom attributes for this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName() ICustomTypeDescriptor.GetClassName() ICustomTypeDescriptor.GetClassName() ICustomTypeDescriptor.GetClassName()

Retourne le nom de classe de cette instance d’un composant.Returns the class name of this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName() ICustomTypeDescriptor.GetComponentName() ICustomTypeDescriptor.GetComponentName() ICustomTypeDescriptor.GetComponentName()

Retourne le nom de cette instance d’un composant.Returns the name of this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter() ICustomTypeDescriptor.GetConverter() ICustomTypeDescriptor.GetConverter() ICustomTypeDescriptor.GetConverter()

Retourne un convertisseur de type pour cette instance d’un composant.Returns a type converter for this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent() ICustomTypeDescriptor.GetDefaultEvent() ICustomTypeDescriptor.GetDefaultEvent() ICustomTypeDescriptor.GetDefaultEvent()

Retourne l’événement par défaut pour cette instance d’un composant.Returns the default event for this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty() ICustomTypeDescriptor.GetDefaultProperty() ICustomTypeDescriptor.GetDefaultProperty() ICustomTypeDescriptor.GetDefaultProperty()

Retourne la propriété par défaut pour cette instance d’un composant.Returns the default property for this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type) ICustomTypeDescriptor.GetEditor(Type) ICustomTypeDescriptor.GetEditor(Type) ICustomTypeDescriptor.GetEditor(Type)

Retourne un éditeur du type spécifié pour cette instance d’un composant.Returns an editor of the specified type for this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents() ICustomTypeDescriptor.GetEvents() ICustomTypeDescriptor.GetEvents() ICustomTypeDescriptor.GetEvents()

Retourne les événements pour cette instance d’un composant.Returns the events for this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[]) ICustomTypeDescriptor.GetEvents(Attribute[]) ICustomTypeDescriptor.GetEvents(Attribute[]) ICustomTypeDescriptor.GetEvents(Attribute[])

Retourne les événements pour cette instance d’un composant à l’aide du tableau d’attributs spécifié comme filtre.Returns the events for this instance of a component using the specified attribute array as a filter.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties() ICustomTypeDescriptor.GetProperties() ICustomTypeDescriptor.GetProperties() ICustomTypeDescriptor.GetProperties()

Retourne les propriétés pour cette instance d’un composant.Returns the properties for this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[]) ICustomTypeDescriptor.GetProperties(Attribute[]) ICustomTypeDescriptor.GetProperties(Attribute[]) ICustomTypeDescriptor.GetProperties(Attribute[])

Retourne les propriétés de cette instance d’un composant à l’aide du tableau d’attributs comme filtre.Returns the properties for this instance of a component using the attribute array as a filter.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor) ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor) ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor) ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)

Retourne un objet qui contient la propriété décrite par le descripteur de propriété spécifié.Returns an object that contains the property described by the specified property descriptor.

(Inherited from DbConnectionStringBuilder)
IDictionary.Add(Object, Object) IDictionary.Add(Object, Object) IDictionary.Add(Object, Object) IDictionary.Add(Object, Object)

Ajoute un élément avec la clé et la valeur fournies à l'objet IDictionary.Adds an element with the provided key and value to the IDictionary object.

(Inherited from DbConnectionStringBuilder)
IDictionary.Contains(Object) IDictionary.Contains(Object) IDictionary.Contains(Object) IDictionary.Contains(Object)

Détermine si l'objet IDictionary contient un élément avec la clé spécifiée.Determines whether the IDictionary object contains an element with the specified key.

(Inherited from DbConnectionStringBuilder)
IDictionary.GetEnumerator() IDictionary.GetEnumerator() IDictionary.GetEnumerator() IDictionary.GetEnumerator()

Retourne un objet IDictionaryEnumerator pour l’objet IDictionary.Returns an IDictionaryEnumerator object for the IDictionary object.

(Inherited from DbConnectionStringBuilder)
IDictionary.Remove(Object) IDictionary.Remove(Object) IDictionary.Remove(Object) IDictionary.Remove(Object)

Supprime de l’objet IDictionary l’élément ayant la clé spécifiée.Removes the element with the specified key from the IDictionary object.

(Inherited from DbConnectionStringBuilder)
IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Retourne un énumérateur qui itère au sein d’une collection.Returns an enumerator that iterates through a collection.

(Inherited from DbConnectionStringBuilder)

Méthodes d’extension

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Voir aussi