OracleConnectionStringBuilder.Remove(String) OracleConnectionStringBuilder.Remove(String) OracleConnectionStringBuilder.Remove(String) OracleConnectionStringBuilder.Remove(String) Method

定義

指定されたキーを持つエントリを OracleConnectionStringBuilder インスタンスから削除します。Removes the entry with the specified key from the OracleConnectionStringBuilder instance.

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

この OracleConnectionStringBuilder 内の接続文字列から削除するキー/値ペアのキー。The key of the key/value pair to be removed from the connection string in this OracleConnectionStringBuilder.

戻り値

接続文字列内にキーが存在し、削除された場合は true。キーが存在しなかった場合は falsetrue if the key existed within the connection string and was removed, false if the key did not exist.

例外

keyword が null (Visual Basic の場合は Nothing) です。keyword is null (Nothing in Visual Basic).

次の例では、既存の接続文字列を Windows 認証の使用から統合セキュリティの使用に変換します。The following example converts an existing connection string from using Windows Authentication to using integrated security. この処理は、接続文字列からユーザー名およびパスワードを削除し、IntegratedSecurity オブジェクトの OracleConnectionStringBuilder プロパティを設定することによって行われます。The example works by removing the user name and password from the connection string, and then setting the IntegratedSecurity property of the OracleConnectionStringBuilder object.

注意

この例には、OracleConnectionStringBuilder による接続文字列の操作方法を示すために、パスワードが含まれています。This example includes a password to demonstrate how OracleConnectionStringBuilder works with connection strings. 実際のアプリケーションでは、Windows 認証を使用することをお勧めします。In your applications, we recommend that you use Windows Authentication. パスワードを使用する必要がある場合も、ハードコードされたパスワードをアプリケーションに含めないでください。If you must use a password, do not include a hard-coded password in your application.

// 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インスタンス。Because the Remove method returns a value that indicates its success, it is not necessary to look for the existence of a key before trying to remove the key/value pair from the OracleConnectionStringBuilder instance. OracleConnectionStringBuilder呼び出しのキー/値ペアの固定サイズ コレクションを保持、Removeメソッドは、既定値に戻すキー/値ペアの値をリセットするだけです。Because the OracleConnectionStringBuilder maintains a fixed-size collection of key/value pairs, calling the Remove method just resets the value of the key/value pair back to its default value.

OracleConnectionStringBuilder でサポートされているキーのコレクションは固定であるため、コレクション内のすべての項目には、既知の既定値があります。Because the collection of keys supported by the OracleConnectionStringBuilder is fixed, every item within the collection has a known default value.

次の表に、各場合のキーと値の一覧、OracleConnectionStringBuilderの初回の初期化後、または、Removeメソッドが呼び出されました。The following table lists the keys, and the value for each when the OracleConnectionStringBuilder is first initialized, or after the Remove method has been called:

キーKey 既定値Default value
データ ソースData Source 空の文字列Empty string
Persist Security InfoPersist Security Info FalseFalse
Integrated SecurityIntegrated Security FalseFalse
User IDUser ID 空の文字列Empty string
パスワードPassword 空の文字列Empty string
EnlistEnlist TrueTrue
PoolingPooling TrueTrue
Min Pool SizeMin Pool Size 00
Max Pool SizeMax Pool Size 100100
UnicodeUnicode FalseFalse
Load Balance TimeoutLoad Balance Timeout 00
Oracle の接続名を省略します。Omit Oracle Connection Name FalseFalse

適用対象

こちらもご覧ください