SqlConnectionStringBuilder.Clear メソッド

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

SqlConnectionStringBuilder.Clear メソッド

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

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

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

Visual Basic (宣言)

Public Overrides Sub Clear

Visual Basic (使用法)

Dim instance As SqlConnectionStringBuilder

instance.Clear

C#

public override void Clear ()

C++

public:
virtual void Clear () override

J#

public void Clear ()

JScript

public override function Clear ()

解説

Clear メソッドは、SqlConnectionStringBuilder からすべてのキー/値ペアを削除し、対応するプロパティをすべてリセットします。たとえば、Count プロパティは 0 に、ConnectionString プロパティは空の文字列に設定されます。

使用例

Clear メソッドを呼び出す例を次に示します。この例では、SqlConnectionStringBuilder に、いくつかのキー/値ペアを格納した後、Clear メソッドを呼び出して、その結果を表示します。

Visual Basic

Imports System.Data.SqlClient
    
Module Module1
    Sub Main()
        Dim builder As New
 SqlConnectionStringBuilder
        builder.DataSource = "(local)"
        builder.IntegratedSecurity = True
        builder.InitialCatalog = "AdventureWorks"
        Console.WriteLine("Initial connection string: "
 & builder.ConnectionString)

        builder.Clear()
        Console.WriteLine("After call to Clear, count = "
 & builder.Count)
        Console.WriteLine("Cleared connection string: "
 & builder.ConnectionString)
        Console.WriteLine()

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

C#

using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder();
        builder.DataSource = "(local)";
        builder.IntegratedSecurity = true;
        builder.InitialCatalog = "AdventureWorks";
        Console.WriteLine("Initial connection string: "
 + builder.ConnectionString);

        builder.Clear();
        Console.WriteLine("After call to Clear, count = " + builder.Count);
        Console.WriteLine("Cleared connection string: "
 + builder.ConnectionString);
        Console.WriteLine();

        Console.WriteLine("Press Enter to continue.");
        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

参照

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