SqlConnectionStringBuilder.Remove(String) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Pacchetto:: System.Data.SqlClient v4.8.6

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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 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

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 ne indica l'esito positivo, non è necessario cercare una chiave prima di tentare di rimuovere la coppia chiave/valore dall'istanza SqlConnectionStringBuilder di . 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	"Provider di dati .Net SqlClient"
Elaborazione asincrona	Falso
AttachDBFilename	stringa vuota
Connection Timeout	15
Connessione di contesto	Falso
Lingua corrente	stringa vuota
origine dati	stringa vuota
Encrypt	Falso
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