OracleConnectionStringBuilder.Remove(String) 方法

定義

命名空間:

System.Data.OracleClient

組件:

System.Data.OracleClient.dll

從 OracleConnectionStringBuilder 執行個體移除具有指定之索引鍵的項目。

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

參數

keyword

String

要從這個 OracleConnectionStringBuilder 的連接字串中移除之索引鍵/值組的索引鍵。

傳回

Boolean

如果連接字串之內有索引鍵而且已經移除，則為 true，如果沒有索引鍵，則為 false。

例外狀況

ArgumentNullException

keyword 是 null (在 Visual Basic 中為 Nothing)。

範例

下列範例會轉換現有的連接字串，將其從使用 Windows 驗證轉換成使用整合式安全性。 此範例運作的方式是從連接字串中移除使用者名稱和密碼，然後設定 IntegratedSecurity 物件的 OracleConnectionStringBuilder 屬性。

注意

這個範例包含了密碼，可示範 OracleConnectionStringBuilder 如何搭配連接字串使用。 我們建議在您的應用程式中使用 Windows 驗證。 如果您必須使用密碼，請勿在您的應用程式中包含硬式編碼的密碼。

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

備註

由於方法會 Remove 傳回指出其成功的值，因此在嘗試從 OracleConnectionStringBuilder 實例中移除索引鍵/值組之前，不需要尋找索引鍵是否存在。 由於 會 OracleConnectionStringBuilder 維護索引鍵/值組的固定大小集合，因此呼叫 Remove 方法只會將索引鍵/值組的值重設為預設值。

因為 OracleConnectionStringBuilder 支援的索引鍵集合是固定的，所以集合中的每一個項目都有已知的預設值。

下表列出索引鍵，以及第一次初始化 時 OracleConnectionStringBuilder ，或呼叫 方法之後 Remove ，每個 索引鍵和值：

Key	預設值
資料來源	空字串
保存安全性資訊	否
整合式安全性	否
使用者識別碼	空字串
密碼	空字串
Enlist	是
Pooling	是
Min Pool Size	0
Max Pool Size	100
Unicode	否
Load Balance Timeout	0
省略 Oracle 連線名稱	否

另請參閱

• 建置連接字串