OleDbConnection.ChangeDatabase(String) Método

Definição

Altera o banco de dados atual para um OleDbConnection aberto.Changes the current database for an open OleDbConnection.

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

Parâmetros

value
String

Nome do banco de dados.The database name.

Implementações

Exceções

O nome do banco de dados não é válido.The database name is not valid.

A conexão não está aberta.The connection is not open.

Não é possível alterar o banco de dados.Cannot change the database.

Exemplos

O exemplo a seguir cria um OleDbConnection e exibe algumas de suas propriedades somente leitura.The following example creates an OleDbConnection and displays some of its read-only properties.

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 parâmetro database deve ser um nome de banco de dados válido.The value supplied in the database parameter must be a valid database name. O parâmetro database não pode conter um valor nulo, uma cadeia de caracteres vazia ou uma cadeia somente com caracteres em branco.The database parameter cannot contain a null value, an empty string, or a string with only blank characters.

Aplica-se a

Veja também