OleDbConnectionStringBuilder.Remove メソッド

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

OleDbConnectionStringBuilder.Remove メソッド

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As OleDbConnectionStringBuilder
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

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

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

例外

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

解説

Remove メソッドでは、処理が成功したかどうかを示す値が返されます。したがって、キー/値ペアを OleDbConnectionStringBuilder のインスタンスから削除する前にキーの存在を確認する必要はありません。

使用例

次の例では、OleDbConnectionStringBuilder を作成し、Remove メソッドの動作を示します。

Visual Basic

Imports System.Data.OleDb    

Module Module1

  Sub Main()
    Dim builder As New OleDbConnectionStringBuilder
    builder.ConnectionString = _
        "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Sample.mdb;"
 & _
        "Jet OLEDB:System Database=C:\system.mdw;"

    Console.WriteLine(builder.ConnectionString)
    ' Try to remove an existing item.
    TryRemove(builder, "Provider")

    ' Try to remove a nonexistent item.
    TryRemove(builder, "User ID")

    ' Try to remove an existing item, 
    ' demonstrating that the search is not 
    ' case sensitive.
    TryRemove(builder, "DATA SOURCE")

    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
  End Sub

  Sub TryRemove(ByVal builder As
 OleDbConnectionStringBuilder, _
      ByVal itemToRemove As String)

    If builder.Remove(itemToRemove) Then
      Console.WriteLine("Removed '{0}'", itemToRemove)
    Else
      Console.WriteLine("Unable to remove '{0}'",
 itemToRemove)
    End If
    Console.WriteLine(builder.ConnectionString)
  End Sub

End Module

C#

using System.Data.OleDb;

class Program
{
    static void Main()
    {
        OleDbConnectionStringBuilder builder =
            new OleDbConnectionStringBuilder();
        builder.ConnectionString =
            "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\\Sample.mdb;"
 +
            "Jet OLEDB:System Database=C:\\system.mdw;";

        Console.WriteLine(builder.ConnectionString);

        // Try to remove an existing item.
        TryRemove(builder, "Provider");

        // Try to remove a nonexistent item.
        TryRemove(builder, "User ID");

        // try to remove an existing item, 
        // demonstrating that the search isn't 
        // case sensitive.
        TryRemove(builder, "DATA SOURCE");

        Console.WriteLine("Press Enter to continue.");
        Console.ReadLine();
    }

    static void TryRemove(OleDbConnectionStringBuilder
 builder, 
        string itemToRemove)
    {

        if (builder.Remove(itemToRemove))
        {
            Console.WriteLine("Removed '{0}'", itemToRemove);
        }
        else
        {
            Console.WriteLine("Unable to remove '{0}'", itemToRemove);
        }
        Console.WriteLine(builder.ConnectionString);
    }
}

プラットフォーム

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

参照

関連項目
OleDbConnectionStringBuilder クラス
OleDbConnectionStringBuilder メンバ
System.Data.OleDb 名前空間
その他の技術情報
Building Connection Strings
接続文字列の使用