SqlConnectionStringBuilder.Remove(String) Metodo

Definizione

Spazio dei nomi:

System.Data.SqlClient

Assembly:

System.Data.dll

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

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

Restituisce

Boolean

true se la chiave esiste all'interno della stringa di connessione ed è stata rimossa; false se la chiave non esiste.

Eccezioni

ArgumentNullException

keyword è null (Nothing in Visual Basic)

Esempio

Nell'esempio seguente viene convertita una stringa di connessione esistente dall'uso dell'autenticazione di SQL Server all'autenticazione di Windows (sicurezza integrata). L'esempio funziona rimuovendo il nome utente e la password dalla stringa di connessione e quindi impostando la proprietà IntegratedSecurity dell'oggetto SqlConnectionStringBuilder.

Avvertimento

Microsoft non consiglia di fornire direttamente il nome utente e la password, perché si tratta di un modello non sicuro. Se possibile, usare flussi di autenticazione più sicuri, ad esempio identità gestite per le risorse di Azureo l'autenticazione di Windows per SQL Server.

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

Commenti

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

Poiché la raccolta di chiavi supportate dal SqlConnectionStringBuilder è fissa, ogni elemento all'interno della raccolta ha un valore predefinito noto. Nella tabella seguente sono elencate le chiavi e il valore per ogni quando il SqlConnectionStringBuilder viene inizializzato per la prima volta o dopo che è stato chiamato il metodo Remove.

Chiave	Valore predefinito
Nome applicazione	".Net SqlClient Data Provider"
Elaborazione asincrona	Falso
AttachDBFilename	Stringa vuota
Timeout connessione	15
Connessione contesto	Falso
Lingua corrente	Stringa vuota
Origine dati	Stringa vuota
Cifrare	Falso
Arruolarsi	Vero
Failover Partner	Stringa vuota
Catalogo iniziale	Stringa vuota
Sicurezza integrata	Falso
Timeout di bilanciamento del carico	0
Dimensioni massime pool	100
Dimensioni minime del pool	0
MultipleActiveResultSets	Falso
Libreria di rete	Stringa vuota
Dimensioni pacchetto	8000
Parola d’ordine	Stringa vuota
Rendere persistenti le informazioni di sicurezza	Falso
Pool	Vero
Replicazione	Falso
Associazione di transazioni	Unbind implicito
ID utente	Stringa vuota
Istanza utente	Falso
Workstation ID	Stringa vuota

Vedi anche

• stringhe di connessione in ADO.NET
• ADO.NET Panoramica