SqlConnectionStringBuilder.Remove(String) Método

Definição

Namespace:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Pacote:

System.Data.SqlClient v4.9.0

Origem:

System.Data.SqlClient.notsupported.cs

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 removida da cadeia de conexão neste SqlConnectionStringBuilder.

Retornos

Boolean

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

Exceções

ArgumentNullException

keyword é nulo (Nothing no Visual Basic)

Exemplos

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

Aviso

A Microsoft não recomenda fornecer seu nome de usuário e senha diretamente, pois é um padrão inseguro. Sempre que possível, use fluxos de autenticação mais seguros, como Identidades Gerenciadas para recursos do Azureou de autenticação do Windows para SQL Server.

using System.Data.SqlClient;

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

            SqlConnectionStringBuilder builder = new(connectString);
            Console.WriteLine($"Original: {builder.ConnectionString}");

            // Remove the User ID and Password.
            builder.Remove("User ID");
            builder.Remove("Password");

            // Enable integrated security.
            builder.IntegratedSecurity = true;

            Console.WriteLine($"Modified: {builder.ConnectionString}");
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}
/* This code example produces the following output:
 * Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password=myPassw0rd
 * Modified: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True
 */

    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)

    ' Remove the user ID and password.
    builder.Remove("User ID")
    builder.Remove("Password")

    ' Turn on integrated security:
    builder.IntegratedSecurity = True

    Console.WriteLine("Modified: " & builder.ConnectionString)

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

' This code produces the following output:
' Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password=a1Pass@@11
' Modified: Data Source = (local);Initial Catalog=AdventureWorks;Integrated Security=True

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 instância SqlConnectionStringBuilder. Como o SqlConnectionStringBuilder mantém uma coleção de tamanho fixo de pares chave/valor, chamar o método Remove 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 para cada quando o SqlConnectionStringBuilder é inicializado pela primeira vez ou depois que o método Remove tiver sido 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
Criptografar	Falso
Alistar	Verdadeiro
Parceiro de failover	Cadeia de caracteres vazia
Catálogo Inicial	Cadeia de caracteres vazia
Segurança Integrada	Falso
Tempo limite do balanceamento de carga	0
Tamanho máximo 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
Manter informações de segurança	Falso
Pool	Verdadeiro
Replicação	Falso
Associação de transação	Desassociado Implícito
Identificação 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 ADO.NET