ConnectionStringSettingsCollection.Clear メソッド

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

ConnectionStringSettingsCollection.Clear メソッド

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

コレクションからすべての ConnectionStringSettings オブジェクトを削除します。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文

Visual Basic (宣言)

Public Sub Clear

Visual Basic (使用法)

Dim instance As ConnectionStringSettingsCollection

instance.Clear

C#

public void Clear ()

C++

public:
void Clear ()

J#

public void Clear ()

JScript

public function Clear ()

解説

Clear メソッドは、現在の構成階層レベルの構成ファイルからすべての接続文字列を削除し、そのファイルに clear タグを書き込みます。clear タグは、親構成ファイルで定義されているすべての接続文字列がシステムによって無視されることを示します。

使用例

ConnectionStringSettings コレクションからすべての ConnectionStringSettingsCollection オブジェクトを削除する方法の例を次に示します。

Visual Basic

' Clear connection strings collection.
Shared Sub ClearConnectionStrings() 
    
    ' Get the application configuration file.
    Dim config _
    As System.Configuration.Configuration = _
    ConfigurationManager.OpenExeConfiguration( _
    ConfigurationUserLevel.None)

    ' Clear the connection strings collection.
    Dim csSection _
    As ConnectionStringsSection = _
    config.ConnectionStrings
    csSection.ConnectionStrings.Clear()
    
    ' Save the configuration file.
    config.Save(ConfigurationSaveMode.Modified)
    
    Console.WriteLine("Connection strings cleared.")

End Sub 'ClearConnectionStrings
 

C#

// Clear connection strings collection.
static void ClearConnectionStrings()
{

    // Get the configuration file.
    System.Configuration.Configuration config =
        ConfigurationManager.OpenExeConfiguration(
        ConfigurationUserLevel.None);

    // Clear the connection strings collection.
    ConnectionStringsSection csSection =
        config.ConnectionStrings;
    csSection.ConnectionStrings.Clear();
   
    // Save the configuration file.
    config.Save(ConfigurationSaveMode.Modified);

    Console.WriteLine("Connection strings cleared.");


}

プラットフォーム

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

参照

関連項目
ConnectionStringSettingsCollection クラス
ConnectionStringSettingsCollection メンバ
System.Configuration 名前空間
ConnectionStringsSection