OracleConnectionStringBuilder.Remove(String) Méthode

Définition

Espace de noms:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Supprime l'entrée contenant la clé spécifiée dans l'instance de OracleConnectionStringBuilder.

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

Retours

Boolean

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

Exceptions

ArgumentNullException

keyword est null (Nothing en Visual Basic).

Exemples

L'exemple suivant convertit une chaîne de connexion existante qui utilise l'authentification Windows en une chaîne de connexion qui utilise la sécurité intégrée. Pour cela, l'exemple supprime le nom d'utilisateur et le mot de passe de la chaîne de connexion, puis définit la propriété IntegratedSecurity de l'objet OracleConnectionStringBuilder.

Notes

Cet exemple inclut un mot de passe pour illustrer l'utilisation de OracleConnectionStringBuilder avec les chaînes de connexion. Dans vos applications, nous vous recommandons d'utiliser l'authentification Windows. Si vous devez utiliser un mot de passe, n'incluez pas de mot de passe codé en dur dans votre application.

// You may need to set a reference to the System.Data.OracleClient
// assembly before you can run this sample.
using System.Data.OracleClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Data Source=OracleDemo;User ID=Mary;Password=*****";

            OracleConnectionStringBuilder builder = new OracleConnectionStringBuilder(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);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        Console.WriteLine("Press any key to finish.");
        Console.ReadLine();
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before you can run this sample.
Imports System.Data.OracleClient

Module Module1

  Sub Main()
    Try
      Dim connectString As String = _
       "Data Source=OracleDemo;User ID=Mary;Password=*****;"

      Dim builder As New OracleConnectionStringBuilder(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)

    Catch ex As Exception
      Console.WriteLine(ex.Message)
    End Try

    Console.WriteLine("Press any key to finish.")
    Console.ReadLine()
  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 OracleConnectionStringBuilder instance. Étant donné que le OracleConnectionStringBuilder conserve une collection de paires clé/valeur de taille fixe, l’appel de la Remove méthode réinitialise simplement la valeur de la paire clé/valeur à sa valeur par défaut.

Étant donné que la collection de clés prise en charge par OracleConnectionStringBuilder est fixe, chaque élément dans la collection a une valeur par défaut connue.

Le tableau suivant répertorie les clés et la valeur de chacune d’elles lors de l’initialisation OracleConnectionStringBuilder ou après l’appel de la Remove méthode :

Clé	Valeur par défaut
source de données	Chaîne vide
Persist Security Info	Faux
Sécurité intégrée	Faux
ID d'utilisateur	Chaîne vide
Mot de passe	Chaîne vide
Enlist	Vrai
Pooling	Vrai
Min Pool Size	0
Max Pool Size	100
Unicode	Faux
Load Balance Timeout	0
Omettre le nom de connexion Oracle	Faux

Voir aussi

• Création de chaînes de connexion