OracleConnectionStringBuilder.Remove メソッド

.NET Framework クラス ライブラリ リファレンス

OracleConnectionStringBuilder.Remove メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定したキーを持つエントリを OracleConnectionStringBuilder インスタンスから削除します。

名前空間: System.Data.OracleClient
アセンブリ: System.Data.OracleClient (system.data.oracleclient.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 Remove ( _
    keyword As String _
) As Boolean

Visual Basic (使用法)

Dim instance As OracleConnectionStringBuilder
Dim keyword As String
Dim returnValue As Boolean

returnValue = instance.Remove(keyword)

C#

public override bool Remove (
    string keyword
)

C++

public:
virtual bool Remove (
    String^ keyword
) override

J#

public boolean Remove (
    String keyword
)

JScript

public override function Remove (
    keyword : String
) : boolean

パラメータ

keyword

この OracleConnectionStringBuilder の接続文字列から取り除く、キー/値ペアに対するキー。

戻り値
接続文字列内にキーが存在し、削除された場合は true。キーが存在しなかった場合は false。

例外

例外の種類	条件
ArgumentNullException	keyword が null (Visual Basic の場合は Nothing) です。

解説

Remove メソッドでは、処理が成功したかどうかを示す値が返されます。したがって、キー/値ペアを OracleConnectionStringBuilder のインスタンスから削除する前にキーが存在するかを検索する必要はありません。OracleConnectionStringBuilder にはキー/値ペアから成る固定サイズのコレクションが保持されるため、Remove メソッドを呼び出しても、キー/値ペアのうち、対象となる値が既定値にリセットされるだけです。

OracleConnectionStringBuilder でサポートされるキーのコレクションは固定的です。そのため、コレクション内のすべての項目には既定値が割り当てられています。

これらのキーおよび対応する値 (最初に OracleConnectionStringBuilder を初期化したときの値または Remove メソッドを呼び出した後の値) の一覧を次の表に示します。

キー	既定値
Data Source	空の文字列
Persist Security Info	False
Integrated Security	False
User ID	空の文字列
Password	空の文字列
Enlist	True
Pooling	True
Min Pool Size	0
Max Pool Size	100
Unicode	False
Load Balance Timeout	0
Omit Oracle Connection Name	False

使用例

次の例では、Windows 認証を使用した既存の接続文字列を統合セキュリティ用に変換しています。この例では、ユーザー名とパスワードを接続文字列から削除し、OracleConnectionStringBuilder オブジェクトの IntegratedSecurity プロパティを設定することによってこれを実現しています。

メモ
この例には、OracleConnectionStringBuilder と接続文字列がどのように連携するかを示すパスワードが含まれています。アプリケーションでは、Windows 認証の使用をお勧めします。パスワードを使用する必要がある場合は、ハードコーディングされたパスワードをアプリケーションに組み込まないでください。

Visual Basic

' 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

C#

// 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();
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
OracleConnectionStringBuilder クラス
OracleConnectionStringBuilder メンバ
System.Data.OracleClient 名前空間
その他の技術情報
Building Connection Strings