SqlConnectionStringBuilder.Remove(String) Metodo

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

Parametri

Restituisce

true se la chiave era presente nella stringa di connessione ed è stata rimossa; false se la chiave non esiste.

Eccezioni

Esempio

Nel seguente esempio viene eseguita la conversione di una stringa di connessione esistente dall'utilizzo di un'autenticazione Windows all'utilizzo della sicurezza integrata. L'esempio funziona eliminando il nome utente e la password dalla stringa di connessione e quindi impostando la proprietà IntegratedSecurity dell'oggetto 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();
    }
}

Nell'esempio viene visualizzato il seguente testo nella finestra della 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  

Commenti

Poiché il metodo Remove restituisce un valore che indica il suo esito positivo, non è necessario cercare una chiave prima di tentare di rimuovere la coppia chiave/valore dall'istanza SqlConnectionStringBuilder . Poiché SqlConnectionStringBuilder gestisce una raccolta a dimensione fissa di coppie chiave/valore, chiamando il metodo Remove viene semplicemente reimpostato il valore della coppia chiave/valore sul suo valore predefinito.

Poiché la raccolta di chiavi supportate da SqlConnectionStringBuilder è fisso, ogni elemento all'interno della raccolta ha un valore noto predefinito. Nella seguente tabella vengono elencate le chiavi ed il loro valore quando SqlConnectionStringBuilder viene inizializzato per la prima volta oppure dopo aver chiamato il metodo Remove.

Si applica a