OdbcConnectionStringBuilder.Remove(String) Méthode

Définition

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

Supprime l’entrée avec la clé spécifiée de l’instance OdbcConnectionStringBuilder .

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 OdbcConnectionStringBuilder.

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 OdbcConnectionStringBuilder instance et illustre le comportement de la Remove méthode.

using System.Data.Odbc;

class Program
{
    static void Main()
    {
        OdbcConnectionStringBuilder builder =
            new OdbcConnectionStringBuilder();
        builder.ConnectionString =
            "Driver={SQL Server};Server=(local);" +
            "Database=AdventureWorks;Trusted_Connection=yes;";

        Console.WriteLine(builder.ConnectionString);

        // Try to remove an existing item.
        TryRemove(builder, "Server");

        // 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, "DATABASE");

        Console.WriteLine("Press Enter to continue.");
        Console.ReadLine();
    }

    static void TryRemove(OdbcConnectionStringBuilder 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.Odbc  
  
Module Module1
  Sub Main()
    Dim builder As New OdbcConnectionStringBuilder
    builder.ConnectionString = _
     "Driver={SQL Server};Server=(local);" & _
     "Database=AdventureWorks;Trusted_Connection=yes;"

    Console.WriteLine(builder.ConnectionString)

    ' Try to remove an existing item.
    TryRemove(builder, "Server")

    ' 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, "DATABASE")

    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
  End Sub

  Sub TryRemove(ByVal builder As OdbcConnectionStringBuilder, _
      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 OdbcConnectionStringBuilder .

S’applique à

Voir aussi