SqlConnectionStringBuilder.Remove(String) Methode

Referenz

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Paket:: System.Data.SqlClient v4.8.6

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 SqlConnectionStringBuilderentfernt werden soll.

Gibt zurück

Boolean

true, wenn der Schlüssel in der Verbindungszeichenfolge vorhanden 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 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.

Warnung

Microsoft empfiehlt nicht, Ihren Benutzernamen und Ihr Kennwort direkt anzugeben, da es sich um ein unsicheres Muster handelt. Verwenden Sie nach Möglichkeit sicherere Authentifizierungsflüsse, z. B. verwaltete Identitäten für Azure-Ressourcen, oder Windows-Authentifizierungs- für 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

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.

Schlüssel	Standardwert
Anwendungsname	".Net SqlClient Data Provider"
Asynchronbetrieb	FALSCH
AttachDBFilename	Leere Zeichenfolge
Abfallzeit	15
Kontextverbindung	FALSCH
Aktuelle Sprache	Leere Zeichenfolge
Datenquelle	Leere Zeichenfolge
Verschlüsseln	FALSCH
Eintragen	STIMMT
Failoverpartner	Leere Zeichenfolge
Anfänglicher Katalog	Leere Zeichenfolge
Integrierte Sicherheit	FALSCH
Timeout für Lastenausgleich	0
Max. Poolgröße	100
Min Poolgröße	0
MultipleActiveResultSets	FALSCH
Netzwerkbibliothek	Leere Zeichenfolge
Paketgröße	8000
Passwort	Leere Zeichenfolge
Sicherheitsinformationen beibehalten	FALSCH
Vereinigend	STIMMT
Replikation	FALSCH
Transaktionsbindung	Implizites Unbind
Benutzer-ID	Leere Zeichenfolge
Benutzerinstanz	FALSCH
Arbeitsstations-ID	Leere Zeichenfolge

Gilt für:

Freigeben über