Udostępnij za pośrednictwem


SqlConnectionStringBuilder.Remove(String) Metoda

Definicja

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 parametry połączenia w tym pliku SqlConnectionStringBuilder.

Zwraca

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

Wyjątki

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

Przykłady

Poniższy przykład konwertuje istniejący parametry połączenia z używania uwierzytelniania systemu Windows do używania zintegrowanych zabezpieczeń. Przykład działa przez usunięcie nazwy użytkownika i hasła z parametry 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 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

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 ".Net SqlClient Data Provider"
Przetwarzanie asynchroniczne Fałsz
Attachdbfilename Pusty ciąg
Przekroczenie limitu czasu połączenia 15
Połączenie kontekstowe Fałsz
Bieżący język Pusty ciąg
Źródło danych Pusty ciąg
Encrypt Fałsz
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

Dotyczy

Zobacz też