SqlConnectionStringBuilder.Remove(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
true
se a chave existia na cadeia de conexão e foi removida; false
se a chave não existia.
Exceções
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 |