SqlConnectionStringBuilder.Remove(String) Metoda

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

Parametry

Zwraca

true jeśli klucz istniał w parametrach połączenia i został usunięty; false jeśli klucz nie istnieje.

Wyjątki

Przykłady

Poniższy przykład konwertuje istniejące parametry połączenia z używania uwierzytelniania systemu Windows do korzystania ze zintegrowanych zabezpieczeń. Przykład działa przez usunięcie nazwy użytkownika i hasła z parametrów połączenia, a następnie ustawienie IntegratedSecurity właściwości SqlConnectionStringBuilder obiektu.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Data Source=(local);User ID=ab;Password=********;" +
                "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();
    }
}

W przykładzie zostanie wyświetlony następujący tekst w oknie konsoli:

Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password=********  
Modified: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True  
Database = AdventureWorks  

Uwagi

Ponieważ metoda Remove zwraca wartość wskazującą jej powodzenie, nie jest wymagane wyszukanie klucza przed próbą usunięcia pary klucz/wartość z SqlConnectionStringBuilder wystąpienia. Ponieważ obiekt SqlConnectionStringBuilder utrzymuje kolekcję par klucz/wartość o stałym rozmiarze, wywołanie Remove metody po prostu resetuje wartość pary klucz/wartość z powrotem do jej wartości domyślnej.

Ponieważ kolekcja kluczy obsługiwanych przez element SqlConnectionStringBuilder jest stała, każdy element w kolekcji ma znaną wartość domyślną. W poniższej tabeli wymieniono klucze i wartość dla każdego, gdy SqlConnectionStringBuilder element jest pierwszy zainicjowany lub po wywołaniu Remove metody.