SqlConnectionStringBuilder.Remove(String) Metodo

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v5.2.0

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

Boolean

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

Eccezioni

ArgumentNullException

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