OracleConnectionStringBuilder.Remove(String) Metodo

Definizione

Spazio dei nomi:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Rimuove la voce con la chiave specificata dall'istanza di 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

Parametri

keyword

String

La chiave della coppia chiave/valore da rimuovere dalla stringa di connessione in questo oggetto OracleConnectionStringBuilder.

Restituisce

Boolean

true se la chiave esisteva all'interno della stringa di connessione ed è stata rimossa. false se la chiave non esisteva.

Eccezioni

ArgumentNullException

keyword è null (Nothing in Visual Basic).

Esempio

Nel seguente esempio viene eseguita la conversione di una stringa di connessione esistente dall'utilizzo di un'autenticazione Windows all'utilizzo della sicurezza integrata. L'esempio funziona eliminando il nome utente e la password dalla stringa di connessione e quindi impostando la proprietà IntegratedSecurity dell'oggetto OracleConnectionStringBuilder.

Nota

In questo esempio è inclusa una password per dimostrare il funzionamento di OracleConnectionStringBuilder con le stringhe di connessione. Nelle applicazioni, è consigliabile utilizzare Windows Authentication. Quando è necessario utilizzare una password, non includere password hardcoded nell'applicazione.

// 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

Commenti

Poiché il Remove metodo restituisce un valore che indica l'esito positivo, non è necessario cercare l'esistenza di una chiave prima di tentare di rimuovere la coppia chiave/valore dall'istanza OracleConnectionStringBuilder . OracleConnectionStringBuilder Poiché mantiene una raccolta di dimensioni fisse di coppie chiave/valore, la chiamata al Remove metodo reimposta semplicemente il valore della coppia chiave/valore sul valore predefinito.

Poiché la raccolta di chiavi supportate da OracleConnectionStringBuilder è fisso, ogni elemento all'interno della raccolta ha un valore noto predefinito.

Nella tabella seguente sono elencate le chiavi e il valore per ogni oggetto quando viene inizializzato per la OracleConnectionStringBuilder prima volta o dopo la chiamata del Remove metodo:

Chiave	Valore predefinito
origine dati	stringa vuota
Persist Security Info	Falso
Sicurezza integrata	Falso
ID utente	stringa vuota
Password	stringa vuota
Inserisci	Vero
Pooling	Vero
Dimensione min pool	0
Dimensione max pool	100
Unicode	Falso
Timeout bilanciamento del carico	0
Omettere il nome della connessione Oracle	Falso

Vedi anche

• Compilazione delle stringhe di connessione