SqlConnectionStringBuilder.Remove(String) Méthode

Définition

Supprime l’entrée avec la clé spécifiée de l’instance SqlConnectionStringBuilder.

public override bool Remove (string keyword);

Paramètres

keyword
String

Clé de la paire clé/valeur à supprimer de la chaîne de connexion dans cette SqlConnectionStringBuilder.

Retours

true si la clé existait dans la chaîne de connexion et a été supprimée ; false si la clé n’existait pas.

Exceptions

keyword a la valeur Null (Nothing en Visual Basic)

Exemples

L’exemple suivant convertit une chaîne de connexion existante à l’aide de l’authentification SQL Server en authentification Windows (sécurité intégrée). L’exemple fonctionne en supprimant le nom d’utilisateur et le mot de passe de la chaîne de connexion, puis en définissant la propriété IntegratedSecurity de l’objet SqlConnectionStringBuilder.

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.

using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Data Source=(local);User ID=ab;Password=myPassw0rd;" +
                "Initial Catalog=AdventureWorks";

            SqlConnectionStringBuilder builder = new(connectString);
            Console.WriteLine($"Original: {builder.ConnectionString}");

            // Remove the User ID and Password.
            builder.Remove("User ID");
            builder.Remove("Password");

            // Enable integrated security.
            builder.IntegratedSecurity = true;

            Console.WriteLine($"Modified: {builder.ConnectionString}");
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}
/* This code example produces the following output:
 * Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password=myPassw0rd
 * Modified: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True
 */

Remarques

Étant donné que la méthode Remove retourne une valeur qui indique sa réussite, il n’est pas nécessaire de rechercher une clé avant d’essayer de supprimer la paire clé/valeur de l’instance SqlConnectionStringBuilder. Étant donné que le SqlConnectionStringBuilder conserve une collection de paires clé/valeur fixe, l’appel de la méthode Remove réinitialise simplement la valeur de la paire clé/valeur à sa valeur par défaut.

Étant donné que la collection de clés prises en charge par l'SqlConnectionStringBuilder est fixe, chaque élément de la collection a une valeur par défaut connue. Le tableau suivant répertorie les clés et la valeur de chaque fois que le SqlConnectionStringBuilder est initialisé pour la première fois, ou après l’appel de la méthode Remove.

Clé Valeur par défaut
Nom de l’application Fournisseur de données .Net SqlClient »
Traitement asynchrone Faux
AttachDBFilename Chaîne vide
Délai d’expiration de la connexion 15
Connexion contextuelle Faux
Langue actuelle Chaîne vide
Source de données Chaîne vide
Chiffrer Faux
S’engager Vrai
Partenaire de basculement Chaîne vide
Catalogue initial Chaîne vide
Sécurité intégrée Faux
Délai d’expiration de l’équilibre de charge 0
Taille maximale du pool 100
Taille minimale du pool 0
MultipleActiveResultSets Faux
Bibliothèque réseau Chaîne vide
Taille des paquets 8000
Mot de passe Chaîne vide
Conserver les informations de sécurité Faux
Mutualisation Vrai
Réplication Faux
Liaison de transaction Dissocié implicite
Identifiant Chaîne vide
Instance utilisateur Faux
ID de station de travail Chaîne vide

S’applique à

Produit Versions
.NET Core 1.0, Core 1.1
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

Voir aussi