| GNOME Data Access manual |
|---|
GdaXmlConnection — Management of connections to XML data sources
struct GdaXmlConnectionPrivate; GdaXmlConnection* gda_xml_connection_new (void); GdaXmlConnection* gda_xml_connection_new_from_file (const gchar *filename); GdaXmlConnection* gda_xml_connection_new_from_string (const gchar *string); gboolean gda_xml_connection_set_from_file (GdaXmlConnection *xmlcnc, const gchar *filename); gboolean gda_xml_connection_set_from_string (GdaXmlConnection *xmlcnc, const gchar *string); const gchar* gda_xml_connection_get_dsn (GdaXmlConnection *xmlcnc); void gda_xml_connection_set_dsn (GdaXmlConnection *xmlcnc, const gchar *dsn); const gchar* gda_xml_connection_get_username (GdaXmlConnection *xmlcnc); void gda_xml_connection_set_username (GdaXmlConnection *xmlcnc, const gchar *username); const gchar* gda_xml_connection_get_password (GdaXmlConnection *xmlcnc); void gda_xml_connection_set_password (GdaXmlConnection *xmlcnc, const gchar *password);
GdaXmlConnection* gda_xml_connection_new (void);
Creates a new GdaXmlConnection object, which lets you parse and/or create .connection files, which are XML files used to specify all parameters needed to open a database connection, and which can be used to store user's connection preferences, or for automatic connection to databases from unattended scripts and such.
| Returns : | the newly created object. |
GdaXmlConnection* gda_xml_connection_new_from_file
(const gchar *filename);Creates a GdaXmlConnection object from the contents of filename, which must be a correct .connection file.
| filename : | name of file to create the GdaXmlConnection object from. |
| Returns : | the newly created object. |
GdaXmlConnection* gda_xml_connection_new_from_string
(const gchar *string);Creates a GdaXmlConnection object from the given XML string.
| string : | XML string to create the GdaXmlConnection object from. |
| Returns : | the newly created object. |
gboolean gda_xml_connection_set_from_file
(GdaXmlConnection *xmlcnc,
const gchar *filename);Loads a XML file into the given GdaXmlConnection object.
| xmlcnc : | a GdaXmlConnection object. |
| filename : | name of a XML file. |
| Returns : | TRUE if successful, FALSE otherwise. |
gboolean gda_xml_connection_set_from_string
(GdaXmlConnection *xmlcnc,
const gchar *string);Loads a XML string into the given GdaXmlConnection object.
| xmlcnc : | a GdaXmlConnection object. |
| string : | XML connection file contents. |
| Returns : | TRUE if successful, FALSE otherwise. |
const gchar* gda_xml_connection_get_dsn (GdaXmlConnection *xmlcnc);
| xmlcnc : | a GdaXmlConnection object. |
| Returns : | the data source name for the given GdaXmlConnection object. |
void gda_xml_connection_set_dsn (GdaXmlConnection *xmlcnc,
const gchar *dsn);Sets the data source name for the given GdaXmlConnection object.
| xmlcnc : | a GdaXmlConnection object. |
| dsn : | data source name. |
const gchar* gda_xml_connection_get_username
(GdaXmlConnection *xmlcnc);
| xmlcnc : | a GdaXmlConnection object. |
| Returns : | the user name defined in the GdaXmlConnection object. |
void gda_xml_connection_set_username (GdaXmlConnection *xmlcnc,
const gchar *username);Sets the user name for the given GdaXmlConnection object.
| xmlcnc : | a GdaXmlConnection object. |
| username : | new user name. |
const gchar* gda_xml_connection_get_password
(GdaXmlConnection *xmlcnc);
| xmlcnc : | a GdaXmlConnection object. |
| Returns : | the password defined in the GdaXmlConnection object. |
| << gda-value | GdaXmlDatabase >> |