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 à 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.

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
 */

    Dim connectString As String =
     "Data Source=(local);User ID=ab;Password=a1Pass@@11;" &
     "Initial Catalog=AdventureWorks"

    Dim builder As New SqlConnectionStringBuilder(connectString)
    Console.WriteLine("Original: " & builder.ConnectionString)

    ' Remove the user ID and password.
    builder.Remove("User ID")
    builder.Remove("Password")

    ' Turn on integrated security:
    builder.IntegratedSecurity = True

    Console.WriteLine("Modified: " & builder.ConnectionString)

Catch ex As Exception
    Console.WriteLine(ex.Message)
End Try

' This code produces the following output:
' Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password=a1Pass@@11
' 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.

S’applique à

Voir aussi

• chaînes de connexion dans ADO.NET
• ADO.NET Vue d’ensemble