IObjectDbEsent Interface

This interface defines the public behaviour of an Object Database backed by an ESENT database.

Namespace: Orthogonal.ObjectDb.Esent
Assembly: Orthogonal.ObjectDb.Esent (in Orthogonal.ObjectDb.Esent.dll) Version: 4.0.0

Syntax

Copy

public interface IObjectDbEsent : IDisposable

The IObjectDbEsent type exposes the following members.

Properties

	Name	Description
	ThrowOnTruncate	Gets or sets a flag indicating if the library should thrown an Exception if an attempt is made to save a string or byte array property value that does not fit into the database column. The default value is True. Setting this property to False will cause silent truncation of values that are too long which is the default behaviour of the library in versions prior to 3.1.

Top

Methods

	Name	Description
	DeleteT	Deletes an object from the database by primary key.
	DeleteAllT	Deletes all objects of a type from the database.
	Export	Exports all data and schema information as an XML element to a stream. The shape and contents of the XML is specific to each Object Database implementation. It is desirable that the Export and Import(Stream) methods can exchange the XML.
	FindFirstByIndexT	Finds the first object in the database with a property value that equals a search value.
	GetT	Gets an object from the database by primary key.
	GetByIndexT	Gets objects from the database by an index over a non primary key property. Because non primary index values may not be unique, a set of results is returned.
	GetObjectNames	Gets the names of all object types stored in the database.
	GetPropertyNames	Gets the names of all properties stored in the database for a given object name.
	GetSchema	Gets the internal structure of the object database as a shaped XML element. This method is only intended to be used for debugging purposes and may only be meaningful for implementations that use a backing storage which supports the concept of a schema.
	Import	Imports all data and schema information from an XML element in a stream. It is desirable that the Import and Export(Stream) methods can exchange the XML.
	InsertT	Inserts a single object into the database. Non identity primary key property value(s) must be set. All public readable and writable property values of the inserted item object are saved. An exception is thrown if the primary key already exists.
	InsertManyT	Inserts a set of objects into the database using a single transaction. All public readable and writable property values of the inserted item objects are saved. Non identity primary key property value(s) must be set. An exception is thrown if the primary key of any item already exists.
	ListT	Lists (enumerates) all objects of a type over the primary key index.
	ListT(SeekType, Object)	Lists (enumerates) all objects of a type over the primary key index starting at a specified seek position.
	ListByIndexT(String)	Lists (enumerates) all objects of a type over an alternative key index.
	ListByIndexT(String, SeekType, Object)	Lists (enumerates) all objects of a type over an alternative key index starting at a specified seek position.
	SaveT	Saves an object into the database, either adding the object if the primary key does not exist, or replacing the data in an existing record with the primary key.
	UpdateT	Updates data in an existing record by primary key. The primary key property value(s) must be set to locate the record to be updated.

Top

Remarks

In the V4 major release that targets .NET standard there is not really a need for an interface any more. The whole database library is now implemented in a single class, but the old interface and the static Create factory methods must remain for compatibility with previous releases.

Reference

Orthogonal.ObjectDb.Esent Namespace