OracleConnectionStringBuilder.Remove(String) Methode

Definition

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Entfernt den Eintrag mit dem angegebenen Schlüssel aus der OracleConnectionStringBuilder-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 OracleConnectionStringBuilder entfernt werden soll.

Gibt zurück

Boolean

true, wenn der Schlüssel innerhalb 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 OracleConnectionStringBuilder-Objekts festgelegt.

Hinweis

Das Beispiel umfasst ein Kennwort zur Veranschaulichung der Funktion von OracleConnectionStringBuilder 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.

// You may need to set a reference to the System.Data.OracleClient
// assembly before you can run this sample.
using System.Data.OracleClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Data Source=OracleDemo;User ID=Mary;Password=*****";

            OracleConnectionStringBuilder builder = new OracleConnectionStringBuilder(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);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        Console.WriteLine("Press any key to finish.");
        Console.ReadLine();
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before you can run this sample.
Imports System.Data.OracleClient

Module Module1

  Sub Main()
    Try
      Dim connectString As String = _
       "Data Source=OracleDemo;User ID=Mary;Password=*****;"

      Dim builder As New OracleConnectionStringBuilder(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)

    Catch ex As Exception
      Console.WriteLine(ex.Message)
    End Try

    Console.WriteLine("Press any key to finish.")
    Console.ReadLine()
  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 OracleConnectionStringBuilder instance zu entfernen. Da die OracleConnectionStringBuilder 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 OracleConnectionStringBuilder unterstützt werden, repariert wurde, besitzt jedes Element in der Sammlung einen bekannten Standardwert.

In der folgenden Tabelle sind die Schlüssel und der Wert für jeden aufgeführt, wenn der OracleConnectionStringBuilder zum ersten Mal initialisiert wird oder nachdem die Remove Methode aufgerufen wurde:

Key	Standardwert
Data source	leere Zeichenfolge
Sicherheitsinformationen permanent speichern	False
Integrierte Sicherheit	False
Benutzer-ID	leere Zeichenfolge
Kennwort	leere Zeichenfolge
Enlist	True
Pooling	True
Min Pool Size	0
Max Pool Size	100
Unicode	False
Load Balance Timeout	0
Oracle-Verbindungsname weglassen	False

Weitere Informationen

• Erstellen von Verbindungszeichenfolgen