SqlConnectionStringBuilder.Remove(String) メソッド

定義

名前空間:

Microsoft.Data.SqlClient

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v5.2.0

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

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

この SqlConnectionStringBuilder 内の接続文字列から削除するキー/値ペアのキー。

戻り値

Boolean

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

例外

ArgumentNullException

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

例

次の例では、既存の接続文字列を Windows 認証の使用から統合セキュリティの使用に変換します。 この処理は、接続文字列からユーザー名およびパスワードを削除し、IntegratedSecurity オブジェクトの SqlConnectionStringBuilder プロパティを設定することによって行われます。

Note

この例には、SqlConnectionStringBuilder による接続文字列の操作方法を示すために、パスワードが含まれています。 実際のアプリケーションでは、Windows 認証を使用することをお勧めします。 パスワードを使用する必要がある場合も、ハードコードされたパスワードをアプリケーションに含めないでください。

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Data Source=(local);User ID=ab;Password= a1Pass@@11;" +
                "Initial Catalog=AdventureWorks";

            SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(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);

            using (SqlConnection
                       connection = new SqlConnection(builder.ConnectionString))
            {
                connection.Open();
                // Now use the open connection.
                Console.WriteLine("Database = " + connection.Database);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }

        Console.WriteLine("Press any key to finish.");
        Console.ReadLine();
    }
}

この例では、次のテキストがコンソール ウィンドウに表示されます。

Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password= a1Pass@@11  
Modified: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True  
Database = AdventureWorks  

注釈

Remove メソッドは成功を示す値を返すので、インスタンスからキーと値のペアを削除する前にキーを検索するSqlConnectionStringBuilder必要はありません。 SqlConnectionStringBuilder では、キー/値ペアの固定サイズ コレクションが管理されているため、Remove メソッドを呼び出した場合には単純に、キー/値ペアの値が元の既定値にリセットされます。

SqlConnectionStringBuilder でサポートされているキーのコレクションは固定であるため、コレクション内のすべての項目には、既知の既定値があります。 次の表は、キーの一覧を示し、各キーについて、SqlConnectionStringBuilder が初めて初期化されたときまたは Remove メソッドが呼び出された後の値を示しています。

Key	既定値
アプリケーション名	.NET Frameworkで実行されている場合は、"Framework Microsoft SqlClient Data Provider" です。 それ以外の場合は、"コア Microsoft SqlClient データ プロバイダー" です。
AttachDBFilename	空の文字列
[接続タイムアウト]	15
Context Connection(Obsolete)	×
[現在の言語]	空の文字列
Data Source	空の文字列
Encrypt	4.0 より前のバージョンでは False、バージョン 4.0 以降では True
Enlist	○
Failover Partner	空の文字列
Initial Catalog	空の文字列
Integrated Security	×
Load Balance Timeout	0
Max Pool Size	100
Min Pool Size	0
MultipleActiveResultSets	×
Network Library	空の文字列
Packet Size	8000
Password	空の文字列
Persist Security Info	×
Pooling	○
レプリケーション	×
Transaction Binding	Implicit Unbind
User ID	空の文字列
User Instance	×
[ワークステーション ID]	空の文字列