SqlConnectionStringBuilder.Remove(String) Methode

Definition

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

Entfernt den Eintrag mit dem angegebenen Schlüssel aus der SqlConnectionStringBuilder-Instanz.

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

Parameter

keyword

String

Der Schlüssel des Schlüssel-Wert-Paars, das aus der Verbindungszeichenfolge in diesem SqlConnectionStringBuilder entfernt werden soll.

Gibt zurück

Boolean

true, wenn der Schlüssel in der Verbindungszeichenfolge vorhanden war und entfernt wurde, false, wenn der Schlüssel nicht vorhanden war.

Ausnahmen

ArgumentNullException

keyword ist NULL (Nothing in Visual Basic).

Beispiele

Im folgenden Beispiel wird für eine vorhandene Verbindungszeichenfolge die Verwendung von integrierter Sicherheit anstelle von Windows-Authentifizierung festgelegt. Dabei werden Benutzername und Kennwort aus der Verbindungszeichenfolge entfernt, und anschließend wird die IntegratedSecurity-Eigenschaft des SqlConnectionStringBuilder-Objekts festgelegt.

Hinweis

Das Beispiel umfasst ein Kennwort zur Veranschaulichung der Funktion von SqlConnectionStringBuilder mit Verbindungszeichenfolgen. In den Anwendungen wird die Verwendung der Windows-Authentifizierung empfohlen. Wenn Sie ein Kennwort verwenden müssen, schließen Sie kein hartcodiertes Kennwort in die Anwendung ein.

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

Im Beispiel wird der folgende Text im Konsolenfenster angezeigt:

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

Hinweise

Da die Remove-Methode einen Wert zurückgibt, der seinen Erfolg angibt, ist es nicht erforderlich, nach einem Schlüssel zu suchen, bevor versucht wird, das Schlüssel-Wert-Paar aus dem SqlConnectionStringBuilder instance zu entfernen. Da der SqlConnectionStringBuilder eine Sammlung von Schlüssel-Wert-Paaren mit fester Größe verwaltet, wird durch Aufrufen der Remove-Methode einfach der Wert des Schlüssel-Wert-Paares auf den Standardwert zurückgesetzt.

Da die Sammlung der Schlüssel, die vom SqlConnectionStringBuilder unterstützt werden, repariert wurde, besitzt jedes Element in der Sammlung einen bekannten Standardwert. In der folgenden Tabelle ist neben den Schlüsseln auch der jeweilige Schlüsselwert aufgeführt, der bei der ersten Initialisierung von SqlConnectionStringBuilder oder nach dem Aufruf der Remove-Methode angegeben wird.

Key	Standardwert
Anwendungsname	".Net SqlClient Data Provider"
Asynchronous Processing	False
AttachDBFilename	leere Zeichenfolge
Verbindungstimeout	15
Kontextverbindung	False
Aktuelle Sprache	leere Zeichenfolge
Data source	leere Zeichenfolge
Verschlüsseln	False
Enlist	True
Failoverpartner	leere Zeichenfolge
Anfangskatalog	leere Zeichenfolge
Integrierte Sicherheit	False
Load Balance Timeout	0
Max Pool Size	100
Min Pool Size	0
MultipleActiveResultSets	False
Network Library	leere Zeichenfolge
Packet Size	8.000
Kennwort	leere Zeichenfolge
Sicherheitsinformationen permanent speichern	False
Pooling	True
Replikation	False
Transaktion Binding	Implicit Unbind
Benutzer-ID	leere Zeichenfolge
User Instance	False
Workstation ID	leere Zeichenfolge

Weitere Informationen

• Verbindungszeichenfolgen in ADO.NET
• Übersicht über ADO.NET