The following graphic shows a high-level UML class diagram of the Tamino API for .NET:
The most frequently used API classes include the following:
TaminoConnection
Represents a connection to a Tamino database. A connection is
necessary in order to be able to create TaminoCommand
s
so that the application can perform operations on the Tamino
database.
TaminoCommand
Provides basic Tamino database commands. The class can handle XML data as well as non-XML (binary) data.
TaminoResponse
Represents information that Tamino returns in response to a command invocation.
TaminoQueryResponse
Represents information that Tamino returns in response to a query command invocation. Methods are provided to permit iteration over the result set.
TaminoPageIterator
Provides page-by-page iteration over the result set of a Tamino query.
TaminoItemIterator
Provides item-by-item iteration, either over the whole result set of a Tamino query or over a single page of the result set.
TaminoTransaction
Represents a Tamino database transaction.
TaminoDataAdapter
Provides support for filling a dataset from Tamino and writing changes made to the dataset back to Tamino.
The basic API classes allow you to use the full power of XML support in
the .NET Framework. Programming using TaminoDataAdapter
and datasets is useful for Rapid Application Development (RAD) and simple XML
data.
The following example illustrates a very simple program:
// create connection TaminoConnection = new TaminoConnection("http://localhost/tamino/mydb"); // open connection connection.Open(TaminoConnectionMode.AutoCommit); // create command TaminoCommand command = connection.CreateCommand("mycollection"); // do simple insert TaminoResponse response = command.Insert(new TaminoDocument(xmlDoc)); Trace.Assert(response.ReturnValue == "0", response.ErrorText); // close connection connection.Close();
Note:
A large set of samples is
provided as part of the installation. They demonstrate various facets of using
the Tamino API for .NET.