OdbcConnectionStringBuilder.Remove(String) Methode

Referenz

Definition

Namespace:: System.Data.Odbc

Assembly:: System.Data.Odbc.dll

Assembly:: System.Data.dll

Paket:: System.Data.Odbc v8.0.0

Paket:: System.Data.Odbc v9.0.0-preview.4.24266.19

Quelle:: OdbcConnectionStringbuilder.cs

Quelle:: OdbcConnectionStringbuilder.cs

Quelle:: OdbcConnectionStringbuilder.cs

Quelle:: OdbcConnectionStringbuilder.cs

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 OdbcConnectionStringBuilder-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 OdbcConnectionStringBuilder 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 eine OdbcConnectionStringBuilder instance erstellt und das Verhalten der Remove Methode veranschaulicht.

using System.Data.Odbc;

class Program
{
    static void Main()
    {
        OdbcConnectionStringBuilder builder =
            new OdbcConnectionStringBuilder();
        builder.ConnectionString =
            "Driver={SQL Server};Server=(local);" +
            "Database=AdventureWorks;Trusted_Connection=yes;";

        Console.WriteLine(builder.ConnectionString);

        // Try to remove an existing item.
        TryRemove(builder, "Server");

        // Try to remove a nonexistent item.
        TryRemove(builder, "User ID");

        // Try to remove an existing item,
        // demonstrating that the search is not
        // case sensitive.
        TryRemove(builder, "DATABASE");

        Console.WriteLine("Press Enter to continue.");
        Console.ReadLine();
    }

    static void TryRemove(OdbcConnectionStringBuilder builder,
        string itemToRemove)
    {

        if (builder.Remove(itemToRemove))
        {
            Console.WriteLine("Removed '{0}'", itemToRemove);
        }
        else
        {
            Console.WriteLine("Unable to remove '{0}'", itemToRemove);
        }
        Console.WriteLine(builder.ConnectionString);
    }
}

Imports System.Data.Odbc  
  
Module Module1
  Sub Main()
    Dim builder As New OdbcConnectionStringBuilder
    builder.ConnectionString = _
     "Driver={SQL Server};Server=(local);" & _
     "Database=AdventureWorks;Trusted_Connection=yes;"

    Console.WriteLine(builder.ConnectionString)

    ' Try to remove an existing item.
    TryRemove(builder, "Server")

    ' Try to remove a nonexistent item.
    TryRemove(builder, "User ID")

    ' Try to remove an existing item, 
    ' demonstrating that the search is not 
    ' case sensitive.
    TryRemove(builder, "DATABASE")

    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
  End Sub

  Sub TryRemove(ByVal builder As OdbcConnectionStringBuilder, _
      ByVal itemToRemove As String)

    If builder.Remove(itemToRemove) Then
      Console.WriteLine("Removed '{0}'", itemToRemove)
    Else
      Console.WriteLine("Unable to remove '{0}'", itemToRemove)
    End If
    Console.WriteLine(builder.ConnectionString)
  End Sub
End Module

Hinweise

Da die Remove Methode einen Wert zurückgibt, der seinen Erfolg angibt, ist es nicht erforderlich, nach dem Vorhandensein eines Schlüssels zu suchen, bevor versucht wird, das Schlüssel-Wert-Paar aus dem OdbcConnectionStringBuilder instance zu entfernen.

Gilt für:

Freigeben über