OleDbConnection.ChangeDatabase(String) Método

  • Referência

Definição

Namespace:
System.Data.OleDb
Assembly:
System.Data.OleDb.dll
Assembly:
System.Data.dll
Pacote:
System.Data.OleDb v8.0.1
Pacote:
System.Data.OleDb v9.0.0-rc.2.24473.5
Origem:
OleDbConnection.cs
Origem:
OleDbConnection.cs

Altera o banco de dados atual para um OleDbConnection aberto.

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

Parâmetros

value
String

Nome do banco de dados.

Implementações

ChangeDatabase(String)

Exceções

ArgumentException

O nome do banco de dados não é válido.

InvalidOperationException

A conexão não está aberta.

OleDbException

Não é possível alterar o banco de dados.

Exemplos

O exemplo a seguir cria um OleDbConnection e exibe algumas de suas propriedades 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

Comentários

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

Aplica-se a

Confira também