SqlConnectionStringBuilder.Remove(String) Método

Definição

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

Pacote:

System.Data.SqlClient v4.8.6

Remove a entrada com a chave especificada da instância de 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

Parâmetros

keyword

String

A chave do par chave/valor a ser removido da cadeia de conexão neste SqlConnectionStringBuilder.

Retornos

Boolean

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

Exceções

ArgumentNullException

keyword é nulo (Nothing no Visual Basic)

Exemplos

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

Observação

Este exemplo inclui uma senha para demonstrar como SqlConnectionStringBuilder funciona com cadeias de conexão. Em seus aplicativos, recomendamos que você use a Autenticação do Windows. Se você precisar usar uma senha, não inclua uma senha codificada em código em seu aplicativo.

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

Imports System.Data.SqlClient
    
Module Module1
  Sub Main()
    Try
      Dim connectString As String = _
       "Data Source=(local);User ID=ab;Password=a1Pass@@11;" & _
       "Initial Catalog=AdventureWorks"

      Dim builder As 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 connection As New SqlConnection(builder.ConnectionString)
        connection.Open()
        ' Now use the open connection.
        Console.WriteLine("Database = " & connection.Database)
      End Using

    Catch ex As Exception
      Console.WriteLine(ex.Message)
    End Try

    Console.WriteLine("Press any key to finish.")
    Console.ReadLine()
  End Sub
End Module

O exemplo exibe o seguinte texto na janela do console:

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

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.

Chave	Valor padrão
Nome do Aplicativo	"Provedor de Dados SqlClient do .Net"
Processamento assíncrono	Falso
AttachDBFilename	cadeia de caracteres vazia
Tempo-limite da conexão	15
Conexão de contexto	Falso
Idioma Atual	cadeia de caracteres vazia
fonte de dados	cadeia de caracteres vazia
Encrypt	Falso
Alistar	Verdadeiro
Failover Partner	cadeia de caracteres vazia
Catálogo Inicial	cadeia de caracteres vazia
Segurança Integrada	Falso
Tempo limite do balanceamento de carga	0
Tamanho Máx do Pool	100
Tamanho mínimo do pool	0
MultipleActiveResultSets	Falso
Biblioteca de rede	cadeia de caracteres vazia
Tamanho do Pacote	8000
Senha	cadeia de caracteres vazia
Informações de Persistência de Segurança	Falso
Agrupamento	Verdadeiro
Replicação	Falso
Associação de transação	Desassociação implícita
Id de Usuário	cadeia de caracteres vazia
Instância do usuário	Falso
ID da Estação de Trabalho	cadeia de caracteres vazia

Confira também

• Cadeias de conexão no ADO.NET
• Visão geral do ADO.NET