# GdaTransaction

## Name

GdaTransaction --

## Synopsis

    struct      GdaTransactionPrivate;
    GdaTransaction* gda_transaction_new         (const gchar *name);
    enum        GdaTransactionIsolation;
    GdaTransactionIsolation gda_transaction_get_isolation_level
                                                (GdaTransaction *xaction);
    void        gda_transaction_set_isolation_level
                                                (GdaTransaction *xaction,
                                                 GdaTransactionIsolation level);
    const gchar* gda_transaction_get_name       (GdaTransaction *xaction);
    void        gda_transaction_set_name        (GdaTransaction *xaction,
                                                 const gchar *name);

## Description

## Details

### struct GdaTransactionPrivate

    struct GdaTransactionPrivate;

### gda_transaction_new ()

    GdaTransaction* gda_transaction_new         (const gchar *name);

Create a new GdaTransaction object, which allows a fine-tune and full control of transactions to be used with providers.

`name` : | name for the transaction.
Returns : | the newly created object.

### enum GdaTransactionIsolation

    typedef enum {
    	GDA_TRANSACTION_ISOLATION_UNKNOWN,
    	GDA_TRANSACTION_ISOLATION_READ_COMMITTED,
    	GDA_TRANSACTION_ISOLATION_READ_UNCOMMITTED,
    	GDA_TRANSACTION_ISOLATION_REPEATABLE_READ,
    	GDA_TRANSACTION_ISOLATION_SERIALIZABLE
    } GdaTransactionIsolation;

### gda_transaction_get_isolation_level ()

    GdaTransactionIsolation gda_transaction_get_isolation_level
                                                (GdaTransaction *xaction);

Get the isolation level for the given transaction. This specifies the locking behavior for the database connection during the given transaction.

`xaction` : | a GdaTransaction object.
Returns : | the isolation level.

### gda_transaction_set_isolation_level ()

    void        gda_transaction_set_isolation_level
                                                (GdaTransaction *xaction,
                                                 GdaTransactionIsolation level);

Set the isolation level for the given transaction.

`xaction` : | a GdaTransaction object.
`level` : | the isolation level.

### gda_transaction_get_name ()

    const gchar* gda_transaction_get_name       (GdaTransaction *xaction);

Retrieve the name of the given transaction, as specified by the client application (via a non-NULL parameter in the call to gda_transaction_new, or by calling gda_transaction_set_name). Note that some providers may set, when you call gda_connection_begin_transaction, the name of the transaction if it's not been specified by the client application, so this function may return, for some providers, values that you don't expect.

`xaction` : | a GdaTransaction object.
Returns : | the name of the transaction.

### gda_transaction_set_name ()

    void        gda_transaction_set_name        (GdaTransaction *xaction,
                                                 const gchar *name);

Set the name of the given transaction. This is very useful when using providers that support named transactions.

`xaction` : | a GdaTransaction object.
`name` : | new name for the transaction.