OleDbConnectionStringBuilder.Remove(String) Méthode

Définition

Espace de noms:
System.Data.OleDb
Assembly:
System.Data.OleDb.dll
Assembly:
System.Data.dll
Paquet:
System.Data.OleDb v11.0.0-preview.4.26230.115
Source:
OleDbConnectionStringBuilder.cs
Source:
OleDbConnectionStringBuilder.cs
Source:
OleDbConnectionStringBuilder.cs
Source:
OleDbConnectionStringBuilder.cs

Supprime l’entrée avec la clé spécifiée de l’instance 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 l’chaîne de connexion dans cette OleDbConnectionStringBuilder.

Retours

Boolean

true si la clé existait dans le chaîne de connexion et a été supprimée, false si la clé n’existait pas.

Exceptions

ArgumentNullException

keyword a la valeur Null (Nothing en Visual Basic).

Exemples

L’exemple suivant crée une OleDbConnectionStringBuilder méthode 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 de l’instance OleDbConnectionStringBuilder .

S’applique à

Voir aussi