SqlConnectionStringBuilder.Remove(String) Méthode

public:
 override bool Remove(System::String ^ keyword);

public override bool Remove (string keyword);

override this.Remove : string -> bool

Public Overrides Function Remove (keyword As String) As Boolean

Paramètres

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

Exemples

L'exemple suivant convertit une chaîne de connexion existante qui utilise l'authentification Windows en une chaîne de connexion qui utilise la sécurité intégrée. Pour cela, l'exemple supprime le nom d'utilisateur et le mot de passe de la chaîne de connexion, puis définit la propriété IntegratedSecurity de l'objet SqlConnectionStringBuilder.

using Microsoft.Data.SqlClient;

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

            SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Original: " + builder.ConnectionString);

            // Use the Remove method
            // in order to reset the user ID and password back to their
            // default (empty string) values. 
            builder.Remove("User ID");
            builder.Remove("Password");

            // Turn on integrated security:
            builder.IntegratedSecurity = true;

            Console.WriteLine("Modified: " + builder.ConnectionString);

            using (SqlConnection
                       connection = new SqlConnection(builder.ConnectionString))
            {
                connection.Open();
                // Now use the open connection.
                Console.WriteLine("Database = " + connection.Database);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }

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

L'exemple affiche le texte suivant dans la fenêtre de console :

Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password= a1Pass@@11  
Modified: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True  
Database = AdventureWorks  

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ée que SqlConnectionStringBuilder conserve une collection de taille fixe de paires clé/valeur, l’appel à la méthode Remove rétablit simplement la valeur par défaut de la valeur de la paire clé/valeur.

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

S’applique à