SqlConnectionStringBuilder.Remove(String) Metodo

Definizione

Rimuove la voce con la chiave specificata dall'istanza di SqlConnectionStringBuilder.

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

keyword
String

La chiave della coppia chiave/valore da rimuovere dalla stringa di connessione in questo oggetto SqlConnectionStringBuilder.

Restituisce

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

Eccezioni

keyword è Null (Nothing in Visual Basic).

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.

Nota

In questo esempio è inclusa una password per dimostrare il funzionamento di SqlConnectionStringBuilder con le stringhe di connessione. Nelle applicazioni, è consigliabile utilizzare Windows Authentication. Quando è necessario utilizzare una password, non includere password hardcoded nell'applicazione.

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.

Chiave Valore predefinito
Nome dell'applicazione "Framework Microsoft SqlClient Data Provider" durante l'esecuzione in .NET Framework. "Core Microsoft SqlClient Data Provider" in caso contrario.
AttachDBFilename stringa vuota
Connection Timeout 15
Connessione contesto(obsoleto) Falso
Lingua corrente stringa vuota
origine dati stringa vuota
Encrypt False nelle versioni precedenti alla versione 4.0, True nelle versioni 4.0 e successive
Inserisci Vero
Partner di failover stringa vuota
Catalogo iniziale stringa vuota
Sicurezza integrata Falso
Timeout bilanciamento del carico 0
Dimensione max pool 100
Dimensione min pool 0
MultipleActiveResultSets Falso
Libreria di rete stringa vuota
Packet Size 8000
Password stringa vuota
Persist Security Info Falso
Pooling Vero
Replica Falso
Associazioni transazionali Implicit Unbind
ID utente stringa vuota
Istanza utente Falso
ID workstation stringa vuota

Si applica a