gda-sharp 0.0.0.0 neutral Gtk# is thread aware, but not thread safe; See the Gtk# Thread Programming for details.

The Gda.Connection class offers access to all operations involving an opened connection to a database. Gda.Connection objects are obtained via the Gda.Client class.

Once obtained, applications can use Gda.Connection to execute commands, run transactions, and get information about all objects stored in the underlying database. GLib.Object GLib.IWrapper System.IDisposable Method System.Void

To be added

To be added Method System.Boolean

Rollbacks the given transaction.

a a true if the operation was successfull, false otherwise This means that all changes made to the underlying data source since the last call to or will be discarded. Method System.Boolean

Starts a transaction on the data source, identified by the xaction parameter.

a a true if the transaction was started successfully, false otherwise Before starting a transaction, you can check whether the underlying provider does support transactions or not by using the method. Method System.Int32

Executes a single command on the underlying database, and gets the number of rows affected.

a a a the numer of affected rows by the executed command, or -1 on error To be added Method System.Boolean

Changes the current database for the given connection. This operation is not available in all providers.

a a true if successful, false otherwise To be added Method System.Boolean

Drops a database from the given connection.

a a true if successful, false otherwise To be added Method System.Void

This is just another convenience method which lets you add a list of GdaError's to the given connection.

a As with , this method makes the connection object emit the "error" signal. The only difference is that, instead of a notification for each error, this function only does one notification for the whole list of errors. Method System.Boolean

Commits the given transaction to the backend database.

a a true if the transaction was finished successfully, false otherwise You need to do first. Method System.Void

Adds an error to the given connection. This function is usually called by providers, to inform clients of errors that happened during some operation.

a As soon as a provider (or a client, it does not matter) calls this function, the connection object (and the associated Gda.Client object) emits the "error" signal, to which clients can connect to be informed of errors. Method System.Boolean

Creates a new database named name on the given connection.

a a true if successful, false otherwise To be added Method System.Boolean

Asks the underlying provider for if a specific feature is supported.

a a true if the provider supports it, false if not To be added Method Gda.DataModel

Executes a single command on the given connection.

a a a This method lets you retrieve a simple data model from the underlying difference, instead of having to retrieve a list of them, as is the case with Method System.Boolean

Closes the connection to the underlying data source. After calling this function, you should not use anymore the Gda.Connection object, since it may have been destroyed.

a true if succesfull, false otherwise. To be added Method GLib.List

Executes a command on the underlying data source.

a a a of This method provides the way to send several commands at once to the data source being accessed by the given object. The specified can contain a list of commands in its "text" property (usually a set of SQL commands separated by ';'). Method Gda.DataModel

Asks the underlying data source for a list of database objects.

a a a containing the data required This is the function that lets applications ask the different providers about all their database objects (tables, views, procedures, etc). The set of database objects that are retrieved are given by the 2 parameters of this function: schema, which specifies the specific schema required, and params, which is a list of parameters that can be used to give more detail about the objects to be returned. Method System.Boolean

Creates a BLOB (Binary Large OBject) with read/write access.

a a false if database does not support BLOBs, true otherwise and the Gda.Blob is created and ready to be used To be added Constructor

To be added

a a To be added Constructor

Creates a new Gda.Connection object.

a a a a a a a It is not intended to be used directly by applications. Use Property System.String

Gets the connection string used to open this connection.

a The connection string is the string sent over to the underlying database provider, which describes the parameters to be used to open a connection on the underlying data source. Property GLib.List

Retrieves a list of the last errors ocurred in the connection.

a You can make a copy of the list using . Property Gda.ConnectionOptions

Gets the used to open this connection.