OdbcConnectionStringBuilder.Clear メソッド

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

OdbcConnectionStringBuilder.Clear メソッド

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

OdbcConnectionStringBuilder インスタンスの内容を消去します。

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

Visual Basic (宣言)

Public Overrides Sub Clear

Visual Basic (使用法)

Dim instance As OdbcConnectionStringBuilder

instance.Clear

C#

public override void Clear ()

C++

public:
virtual void Clear () override

J#

public void Clear ()

JScript

public override function Clear ()

解説

Clear メソッドは、OdbcConnectionStringBuilder からすべてのキー/値ペアを削除し、Driver プロパティおよび Dsn プロパティを既定値にリセットします。また、Clear メソッドでは、Count プロパティが 0 に、ConnectionString プロパティが空の文字列に設定されます。

使用例

Visual Basic

Imports System.Data.Odbc    

Module Module1
  Sub Main()
    Dim builder As New OdbcConnectionStringBuilder()

    ' Call the Add method to explicitly add key/value
    ' pairs to the internal collection.
    builder.Driver = "Microsoft Excel Driver (*.xls)"
    builder("Dbq") = "C:\Data.xls"
    builder("DriverID") = "790"
    builder("DefaultDir") = "C:\"

    ' Dump the contents of the "filled-in" OdbcConnectionStringBuilder
    ' to the console window.
    DumpBuilderContents(builder)

    ' Clear current values and reset known keys to their
    ' default values.
    builder.Clear()

    ' Dump the contents of the newly emptied 
    ' OdbcConnectionStringBuilder
    ' to the console window.
    DumpBuilderContents(builder)

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

  Private Sub DumpBuilderContents(ByVal
 builder As OdbcConnectionStringBuilder)
    Console.WriteLine("=================")
    Console.WriteLine("builder.ConnectionString = "
 & builder.ConnectionString)
    For Each key As String
 In builder.Keys
      Console.WriteLine(key & "=" & builder.Item(key).ToString)
    Next
  End Sub
End Module

C#

using System.Data.Odbc;
class Program
{
    static void Main()
    {
        OdbcConnectionStringBuilder builder = new OdbcConnectionStringBuilder();

        // Call the Add method to explicitly add key/value
        // pairs to the internal collection.
        builder.Driver = "Microsoft Excel Driver (*.xls)";
        builder["Dbq"] = "C:\\Data.xls";
        builder["DriverID"] = "790";
        builder["DefaultDir"] = "C:\\";

        // Dump the contents of the "filled-in" OdbcConnectionStringBuilder
        // to the Console window:
        DumpBuilderContents(builder);

        // Clear current values and reset known keys to their
        // default values.
        builder.Clear();

        // Dump the contents of the newly emptied OdbcConnectionStringBuilder
        // to the console window.
        DumpBuilderContents(builder);

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

    private static void
 DumpBuilderContents(OdbcConnectionStringBuilder builder)
    {
        Console.WriteLine("=================");
        Console.WriteLine("builder.ConnectionString = " + builder.ConnectionString);
        foreach (string key in
 builder.Keys)
        {
            Console.WriteLine(key + "=" + builder[key].ToString());
        }
    }
}

プラットフォーム

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

参照

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