OleDbConnection.ChangeDatabase(String) Método

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v9.0.0-rc.2.24473.5

Altera o banco de dados atual para um OleDbConnection aberto.

public:
 override void ChangeDatabase(System::String ^ value);

public override void ChangeDatabase (string value);

override this.ChangeDatabase : string -> unit

Public Overrides 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.

Confira também

• Conectando-se a fontes de dados