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 System.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();
    }
}

Imports System.Data.SqlClient
    
Module Module1
  Sub Main()
    Try
      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)

      ' 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 connection As New SqlConnection(builder.ConnectionString)
        connection.Open()
        ' Now use the open connection.
        Console.WriteLine("Database = " & connection.Database)
      End Using

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

    Console.WriteLine("Press any key to finish.")
    Console.ReadLine()
  End Sub
End Module

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 du SqlConnectionStringBuilder instance. É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 à

Voir aussi

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