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	既定値
Data Source	空の文字列
Persist Security Info	×
Integrated Security	×
User ID	空の文字列
Password	空の文字列
Enlist	○
Pooling	○
Min Pool Size	0
Max Pool Size	100
Unicode	×
Load Balance Timeout	0
Oracle 接続名を省略する	×

こちらもご覧ください

• 接続文字列の作成