SqlConnectionStringBuilder.Remove(String) Método

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

Parâmetros

Retornos

true se a chave existia na cadeia de conexão e foi removida; false se a chave não existia.

Exceções

Exemplos

O exemplo a seguir converte uma cadeia de conexão existente de usando a Autenticação do Windows em usando a segurança integrada. O exemplo funciona removendo o nome de usuário e a senha da cadeia de conexão e definindo a IntegratedSecurity propriedade do SqlConnectionStringBuilder objeto.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Data Source=(local);User ID=ab;Password=********;" +
                "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();
    }
}

O exemplo exibe o seguinte texto na janela do console:

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

Comentários

Como o método Remove retorna um valor que indica seu êxito, não é necessário procurar uma chave antes de tentar remover o par chave/valor da SqlConnectionStringBuilder instância. Como o SqlConnectionStringBuilder mantém uma coleção de tamanho fixo de pares chave/valor, chamar o Remove método simplesmente redefine o valor do par chave/valor de volta para seu valor padrão.

Como a coleção de chaves com suporte pelo SqlConnectionStringBuilder é fixa, cada item dentro da coleção tem um valor padrão conhecido. A tabela a seguir lista as chaves e o valor de cada quando o SqlConnectionStringBuilder é inicializado pela primeira vez ou depois que o Remove método é chamado.