![]() |
![]() |
![]() |
GNOME Data Access manual | ![]() |
---|---|---|---|---|
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. |