Export (0) Print
Expand All

SqlConnectionStringBuilder.Remove Method

Removes the entry with the specified key from the SqlConnectionStringBuilder instance.

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

public override bool Remove (
	string keyword
)
public boolean Remove (
	String keyword
)
public override function Remove (
	keyword : String
) : boolean
Not applicable.

Parameters

keyword

The key of the key/value pair to be removed from the connection string in this SqlConnectionStringBuilder.

Return Value

true if the key existed within the connection string and was removed; false if the key did not exist.

Exception typeCondition

ArgumentNullException

keyword is null (Nothing in Visual Basic)

Because the Remove method returns a value that indicates its success, it is not required to look for a key before trying to remove the key/value pair from the SqlConnectionStringBuilder instance. Because the SqlConnectionStringBuilder maintains a fixed-size collection of key/value pairs, calling the Remove method simply resets the value of the key/value pair back to its default value.

Because the collection of keys supported by the SqlConnectionStringBuilder is fixed, every item within the collection has a known default value. The following table lists the keys, and the value for each when the SqlConnectionStringBuilder is first initialized, or after the Remove method has been called.

Key

Default value

Application Name

".Net SqlClient Data Provider"

Asynchronous Processing

False

AttachDBFilename

Empty string

Connection Reset

True

Connection Timeout

15

Context Connection

False

Current Language

Empty string

Data Source

Empty string

Encrypt

False

Enlist

True

Failover Partner

Empty string

Initial Catalog

Empty string

Integrated Security

False

Load Balance Timeout

0

Max Pool Size

100

Min Pool Size

0

MultipleActiveResultSets

False

Network Library

Empty string

Packet Size

8000

Password

Empty string

Persist Security Info

False

Pooling

True

Replication

False

User ID

Empty string

User Instance

False

Workstation ID

Empty string

The following example converts an existing connection string from using Windows Authentication to using integrated security. The example works by removing the user name and password from the connection string, and then setting the IntegratedSecurity property of the SqlConnectionStringBuilder object.

NoteNote:

This example includes a password to demonstrate how SqlConnectionStringBuilder works with connection strings. In your applications, we recommend that you use Windows Authentication. If you must use a password, do not include a hard-coded password in your application.

using System.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();
    }
}

The example displays the following text in the console window:

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

Windows 98, Windows Server 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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show:
© 2014 Microsoft