OleDbConnection.ChangeDatabase(String) Methode

Definition

Ändert die aktuelle Datenbank für eine offene OleDbConnection.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)

Parameter

value
String

Der Datenbankname.The database name.

Implementiert

Ausnahmen

Der Datenbankname ist ungültig.The database name is not valid.

Die Verbindung ist nicht geöffnet.The connection is not open.

Die Datenbank kann nicht geändert werden.Cannot change the database.

Beispiele

Im folgenden Beispiel wird eine OleDbConnection erstellt und einige der schreibgeschützten Eigenschaften angezeigt.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

Hinweise

Der im database-Parameter angegebene Wert muss ein gültiger Datenbankname sein.The value supplied in the database parameter must be a valid database name. Der database-Parameter darf keinen NULL-Wert, keine leere Zeichenfolge oder eine Zeichenfolge enthalten, die nur Leerzeichen enthält.The database parameter cannot contain a null value, an empty string, or a string with only blank characters.

Gilt für:

Siehe auch