OleDbConnectionStringBuilder.Remove(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Supprime l'entrée contenant la clé spécifiée dans l'instance 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
Paramètres
- keyword
- String
Clé de la paire clé/valeur à supprimer de la chaîne de connexion dans OleDbConnectionStringBuilder.
Retours
true
si la clé existait dans la chaîne de connexion et a été supprimée ; false
si la clé n'existait pas.
Exceptions
keyword
est null (Nothing
en Visual Basic).
Exemples
L’exemple suivant crée un OleDbConnectionStringBuilder et illustre le comportement de la Remove méthode .
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
Remarques
Étant donné que la Remove méthode retourne une valeur qui indique sa réussite, il n’est pas nécessaire de rechercher l’existence d’une clé avant d’essayer de supprimer la paire clé/valeur du OleDbConnectionStringBuilder instance.