SqlConnectionStringBuilder.Remove(String) Metoda

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.dll

Usuwa wpis z określonym kluczem z wystąpienia 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

Parametry

keyword

String

Klucz pary klucz/wartość, który ma zostać usunięty z parametrów połączenia w tym 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 uwierzytelniania programu SQL Server na uwierzytelnianie systemu Windows (zintegrowane zabezpieczenia). Przykład działa przez usunięcie nazwy użytkownika i hasła z parametrów połączenia, a następnie ustawienie właściwości IntegratedSecurity obiektu SqlConnectionStringBuilder.

Ostrzeżenie

Firma Microsoft nie zaleca bezpośredniego podawania nazwy użytkownika i hasła, ponieważ jest to niezabezpieczony wzorzec. Jeśli to możliwe, należy użyć bezpieczniejszych przepływów uwierzytelniania, takich jak tożsamości zarządzane dla zasobów platformy Azurelub uwierzytelniania systemu Windows dla programu 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

Uwagi

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

Ponieważ kolekcja kluczy obsługiwanych przez 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 jest najpierw zainicjowana lub po wywołaniu metody Remove.

Klucz	Wartość domyślna
Nazwa aplikacji	".Net SqlClient Data Provider"
Przetwarzanie asynchroniczne	Fałszywy
AttachDBFilename	Pusty ciąg
Limit czasu połączenia	15
Połączenie kontekstowe	Fałszywy
Bieżący język	Pusty ciąg
Źródło danych	Pusty ciąg
Szyfrować	Fałszywy
Zarejestrować	Prawdziwy
Failover Partner	Pusty ciąg
Katalog początkowy	Pusty ciąg
Zabezpieczenia zintegrowane	Fałszywy
Limit czasu równoważenia obciążenia	0
Maksymalny rozmiar puli	100
Minimalny rozmiar puli	0
MultipleActiveResultSets	Fałszywy
Biblioteka sieciowa	Pusty ciąg
Rozmiar pakietu	8000
Hasło	Pusty ciąg
Utrwalanie informacji zabezpieczających	Fałszywy
Buforowanie	Prawdziwy
Replikacja	Fałszywy
Powiązanie transakcji	Niejawne powiązanie
Identyfikator użytkownika	Pusty ciąg
Wystąpienie użytkownika	Fałszywy
Identyfikator stacji roboczej	Pusty ciąg

Zobacz też

• parametry połączenia w ADO.NET
• ADO.NET — omówienie