SqlConnectionStringBuilder.Remove(String) Methode

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

Gibt zurück

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

Ausnahmen

Beispiele

Im folgenden Beispiel wird eine vorhandene Verbindungszeichenfolge von der Verwendung der SQL Server-Authentifizierung in die Windows-Authentifizierung (integrierte Sicherheit) konvertiert. Das Beispiel funktioniert, indem der Benutzername und das Kennwort aus der Verbindungszeichenfolge entfernt und dann die IntegratedSecurity Eigenschaft des SqlConnectionStringBuilder-Objekts festgelegt wird.

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

Hinweise

Da die Remove -Methode einen Wert zurückgibt, der den Erfolg angibt, ist es nicht erforderlich, nach einem Schlüssel zu suchen, bevor Sie versuchen, das Schlüssel-Wert-Paar aus der SqlConnectionStringBuilder Instanz zu entfernen. Da die SqlConnectionStringBuilder eine Sammlung von Schlüssel-Wert-Paaren mit fester Größe verwaltet, setzt das Aufrufen der Remove-Methode einfach den Wert des Schlüssel-Wert-Paars auf den Standardwert zurück.

Da die Sammlung von Schlüsseln, die von der SqlConnectionStringBuilder unterstützt werden, behoben ist, weist jedes Element in der Auflistung einen bekannten Standardwert auf. In der folgenden Tabelle sind die Schlüssel und der Wert für die einzelnen Schlüssel aufgeführt, wenn die SqlConnectionStringBuilder zum ersten Mal initialisiert wird oder nachdem die Remove Methode aufgerufen wurde.

Gilt für:

Weitere Informationen

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