OleDbConnection.ChangeDatabase(String) Método

Definição

Espaço de Nomes:
System.Data.OleDb
Assemblagem:
System.Data.dll

Altera a base de dados atual para um .OleDbConnection

public:
 virtual void ChangeDatabase(System::String ^ value);
public:
 override void ChangeDatabase(System::String ^ value);
public void ChangeDatabase(string value);
public override void ChangeDatabase(string value);
abstract member ChangeDatabase : string -> unit
override this.ChangeDatabase : string -> unit
override this.ChangeDatabase : string -> unit
Public Sub ChangeDatabase (value As String)
Public Overrides Sub ChangeDatabase (value As String)

Parâmetros

value
String

O nome do banco de dados.

Implementações

ChangeDatabase(String)

Exceções

ArgumentException

O nome da base de dados não é válido.

InvalidOperationException

A ligação não está aberta.

OleDbException

Não é possível alterar a base de dados.

Exemplos

O exemplo seguinte cria um OleDbConnection e apresenta algumas das suas propriedades de somente leitura.

static void ChangeDatabaseConnection(string connectionString)
{
   using (OleDbConnection connection = new OleDbConnection(connectionString))
   {
      try
      {
         connection.Open();
         Console.WriteLine("ServerVersion: {0} \nDatabase: {1}",
             connection.ServerVersion, connection.Database);

         connection.ChangeDatabase("Northwind");
         Console.WriteLine("ServerVersion: {0} \nDatabase: {1}",
            connection.ServerVersion, connection.Database);
      }
      catch (Exception ex)
      {
         Console.WriteLine(ex.Message);
      }
      // The connection is automatically closed when the
      // code exits the using block.
   }
}

Public Sub ChangeDatabaseConnection(ByVal connectionString As String)

   Using connection As New OleDbConnection(connectionString)
      Try
         connection.Open()
         Console.WriteLine("Server Version: {0} Database: {1}", _
             connection.ServerVersion, connection.Database)
         connection.ChangeDatabase("Northwind")
         Console.WriteLine("Server Version: {0} Database: {1}", _
            connection.ServerVersion, connection.Database)

      Catch ex As Exception
         Console.WriteLine(ex.Message)
      End Try
      ' The connection is automatically closed when the
      ' code exits the Using block.
   End Using
End Sub

Observações

O valor fornecido no database parâmetro deve ser um nome válido de base de dados. O database parâmetro não pode conter um valor nulo, uma cadeia vazia ou uma cadeia com apenas caracteres em branco.

Aplica-se a

Ver também