OleDbConnectionStringBuilder.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 OleDbConnectionStringBuilder.
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 OleDbConnectionStringBuilder.
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 cria um OleDbConnectionStringBuilder e demonstra o comportamento do Remove método .
using System.Data.OleDb;
class Program
{
static void Main()
{
OleDbConnectionStringBuilder builder =
new OleDbConnectionStringBuilder();
builder.ConnectionString =
"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\\Sample.mdb;" +
"Jet OLEDB:System Database=C:\\system.mdw;";
Console.WriteLine(builder.ConnectionString);
// Try to remove an existing item.
TryRemove(builder, "Provider");
// Try to remove a nonexistent item.
TryRemove(builder, "User ID");
// try to remove an existing item,
// demonstrating that the search isn't
// case sensitive.
TryRemove(builder, "DATA SOURCE");
Console.WriteLine("Press Enter to continue.");
Console.ReadLine();
}
static void TryRemove(OleDbConnectionStringBuilder builder,
string itemToRemove)
{
if (builder.Remove(itemToRemove))
{
Console.WriteLine("Removed '{0}'", itemToRemove);
}
else
{
Console.WriteLine("Unable to remove '{0}'", itemToRemove);
}
Console.WriteLine(builder.ConnectionString);
}
}
Imports System.Data.OleDb
Module Module1
Sub Main()
Dim builder As New OleDbConnectionStringBuilder
builder.ConnectionString = _
"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Sample.mdb;" & _
"Jet OLEDB:System Database=C:\system.mdw;"
Console.WriteLine(builder.ConnectionString)
' Try to remove an existing item.
TryRemove(builder, "Provider")
' Try to remove a nonexistent item.
TryRemove(builder, "User ID")
' Try to remove an existing item,
' demonstrating that the search is not
' case sensitive.
TryRemove(builder, "DATA SOURCE")
Console.WriteLine("Press Enter to continue.")
Console.ReadLine()
End Sub
Sub TryRemove(ByVal builder As OleDbConnectionStringBuilder, _
ByVal itemToRemove As String)
If builder.Remove(itemToRemove) Then
Console.WriteLine("Removed '{0}'", itemToRemove)
Else
Console.WriteLine("Unable to remove '{0}'", itemToRemove)
End If
Console.WriteLine(builder.ConnectionString)
End Sub
End Module
Comentários
Como o Remove método retorna um valor que indica seu êxito, não é necessário procurar a existência de uma chave antes de tentar remover o par chave/valor da OleDbConnectionStringBuilder instância.