SqlConnectionStringBuilder.Remove(String) Metoda

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.SqlClient.dll

Pakiet:

System.Data.SqlClient v4.8.6

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

Boolean

truejeśli klucz istniał w parametry 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ą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

Zobacz też

• Parametry połączenia w ADO.NET
• Omówienie ADO.NET