SqlConnectionStringBuilder.Remove(String) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Usuwa wpis z określonym kluczem SqlConnectionStringBuilder z wystąpienia.

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

keyword

String

Klucz pary klucz/wartość, który ma zostać usunięty z parametrów połączenia w tym pliku SqlConnectionStringBuilder.

Zwraca

Boolean

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

Wyjątki

ArgumentNullException

keyword ma wartość null (Nothing w Visual Basic)

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.

Uwaga

Ten przykład zawiera hasło, które pokazuje, jak SqlConnectionStringBuilder działa z parametrami połączenia. W aplikacjach zalecamy użycie uwierzytelniania systemu Windows. Jeśli musisz użyć hasła, nie dołączaj w aplikacji trwale zakodowanego hasła.

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();
    }
}

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

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  

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.

Klucz	Wartość domyślna
Nazwa aplikacji	"Framework Microsoft SqlClient Data Provider" podczas uruchamiania w .NET Framework. "Core Microsoft SqlClient Data Provider" w przeciwnym razie.
Attachdbfilename	Pusty ciąg
Przekroczenie limitu czasu połączenia	15
Połączenie kontekstowe (przestarzałe)	Fałsz
Bieżący język	Pusty ciąg
Źródło danych	Pusty ciąg
Szyfrowanie	Fałsz w wersjach wcześniejszych niż 4.0, Prawda w wersjach 4.0 i nowszych
Zarejestrować	Prawda
Failover Partner	Pusty ciąg
Katalog początkowy	Pusty ciąg
Zintegrowane zabezpieczenia	Fałsz
Limit czasu równoważenia obciążenia	0
Maksymalny rozmiar puli	100
Minimalny rozmiar puli	0
MultipleActiveResultSets	Fałsz
Biblioteka sieciowa	Pusty ciąg
Rozmiar pakietu	8000
Hasło	Pusty ciąg
Utrwalanie informacji zabezpieczających	Fałsz
Buforowanie	Prawda
Replikacja	Fałsz
Powiązanie transakcji	Niejawne powiązanie
Identyfikator użytkownika	Pusty ciąg
Wystąpienie użytkownika	Fałsz
Identyfikator stacji roboczej	Pusty ciąg