OracleConnectionStringBuilder.Remove(String) Metoda

Definicja

Przestrzeń nazw:

System.Data.OracleClient

Zestaw:

System.Data.OracleClient.dll

Usuwa wpis z określonym kluczem OracleConnectionStringBuilder z wystąpienia.

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

Parametry

keyword

String

Klucz pary klucz/wartość, który ma zostać usunięty z parametry połączenia w tym pliku OracleConnectionStringBuilder.

Zwraca

Boolean

truejeśli klucz istniał w parametry połączenia i został usunięty, false jeśli klucz nie istnieje.

Wyjątki

ArgumentNullException

keyword ma wartość null (Nothing w Visual Basic).

Przykłady

Poniższy przykład konwertuje istniejący parametry połączenia z używania uwierzytelniania systemu Windows do używania zintegrowanych zabezpieczeń. Przykład działa przez usunięcie nazwy użytkownika i hasła z parametry połączenia, a następnie ustawienie IntegratedSecurity właściwości OracleConnectionStringBuilder obiektu.

Uwaga

Ten przykład zawiera hasło, które pokazuje, jak OracleConnectionStringBuilder działa z parametrami połączenia. W aplikacjach zalecamy użycie uwierzytelniania systemu Windows. Jeśli musisz użyć hasła, nie dołączaj w aplikacji trwale zakodowanego hasła.

// 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

Uwagi

Remove Ponieważ metoda zwraca wartość wskazującą jej powodzenie, nie jest konieczne wyszukanie istnienia klucza przed próbą usunięcia pary klucz/wartość z OracleConnectionStringBuilder wystąpienia. Ponieważ obiekt OracleConnectionStringBuilder utrzymuje kolekcję par klucz/wartość o stałym rozmiarze, wywołanie Remove metody po prostu resetuje wartość pary klucz/wartość z powrotem do jej wartości domyślnej.

Ponieważ kolekcja kluczy obsługiwanych przez element OracleConnectionStringBuilder jest stała, każdy element w kolekcji ma znaną wartość domyślną.

W poniższej tabeli wymieniono klucze i wartość dla każdego, gdy OracleConnectionStringBuilder element jest pierwszy zainicjowany lub po wywołaniu Remove metody:

Klucz	Wartość domyślna
Źródło danych	Pusty ciąg
Utrwalanie informacji zabezpieczających	Fałsz
Zintegrowane zabezpieczenia	Fałsz
Identyfikator użytkownika	Pusty ciąg
Hasło	Pusty ciąg
Zarejestrować	Prawda
Buforowanie	Prawda
Minimalny rozmiar puli	0
Maksymalny rozmiar puli	100
Unicode	Fałsz
Limit czasu równoważenia obciążenia	0
Pomiń nazwę połączenia Oracle	Fałsz

Zobacz też

• Kompilowanie parametrów połączenia