OracleConnectionStringBuilder.Remove(String) Metoda

Definice

Obor názvů:

System.Data.OracleClient

Sestavení:

System.Data.OracleClient.dll

Odebere z instance položku se zadaným OracleConnectionStringBuilder klíčem.

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

Klíč dvojice klíč/hodnota, který se má odebrat z připojovací řetězec v tomto OracleConnectionStringBuildersouboru .

Návraty

Boolean

truepokud klíč existoval v rámci připojovací řetězec a byl odebrán, false pokud klíč neexistoval.

Výjimky

ArgumentNullException

keyword is null (Nothing v jazyce Visual Basic).

Příklady

Následující příklad převede existující připojovací řetězec z ověřování systému Windows na použití integrovaného zabezpečení. Příklad funguje tak, že odebere uživatelské jméno a heslo z připojovací řetězec a pak nastaví IntegratedSecurity vlastnost objektuOracleConnectionStringBuilder.

Poznámka

Tento příklad obsahuje heslo, které ukazuje, jak OracleConnectionStringBuilder funguje s připojovacími řetězci. Ve vašich aplikacích doporučujeme používat ověřování systému Windows. Pokud je nutné použít heslo, nevkládejte do své aplikace pevně zakódované heslo.

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

Poznámky

Remove Vzhledem k tomu, že metoda vrátí hodnotu, která označuje její úspěch, není nutné hledat existenci klíče před pokusem o odebrání páru klíč-hodnota z OracleConnectionStringBuilder instance. Vzhledem k tomu, že OracleConnectionStringBuilder objekt udržuje kolekci párů klíč/hodnota s pevnou velikostí, volání Remove metody pouze resetuje hodnotu páru klíč/hodnota zpět na výchozí hodnotu.

Vzhledem k tomu, že kolekce klíčů podporovaných parametrem OracleConnectionStringBuilder je pevná, má každá položka v kolekci známou výchozí hodnotu.

Následující tabulka uvádí klíče a hodnoty pro každý z nich při OracleConnectionStringBuilder první inicializaci nebo po Remove zavolání metody:

Klíč	Výchozí hodnota
Zdroj dat	Prázdný řetězec
Zachování bezpečnostních údajů	Ne
Integrované zabezpečení	Ne
ID uživatele	Prázdný řetězec
Heslo	Prázdný řetězec
Zařazení	Ano
Sdružování	Ano
Minimální velikost fondu	0
Maximální velikost fondu	100
Kódování Unicode	Ne
Vypršení časového limitu vyrovnávání zatížení	0
Vynechání názvu připojení Oracle	Ne

Viz také

• Vytváření připojovacích řetězců