Telerik OpenAccess ORM actually consists of a set of assemblies. These runtime assemblies (required to run a Telerik OpenAccess ORM based application) reside in the \bin folder of your Telerik OpenAccess ORM installation. Assemblies that are required by the VisualStudio integration and the design-time of Telerik OpenAccess ORM are located in the \sdk folder of your installation.
The Telerik.OpenAccess.Adonet2.dll assembly contains the database-specific classes used for accessing all supported databases (MS SQL2005 Server, Oracle (via ODP .NET), MySQL, Advantage Database Server (ADS), SQL Anywhere, SQL Azure, Microsoft SQL CE and Firebird included).
In the Q2 2011 release the Adonet2 assembly is removed from Telerik OpenAccess ORM. All the code is now incorporated in the Telerik.OpenAccess.Runtime.dll assembly.
You are not required to install the Telerik OpenAccess ORM runtime assemblies in the global assembly cache. You can deploy the runtime assemblies in the directory structure of any application that uses the Telerik OpenAccess ORM. This simplifies deployment because you can use the xcopy command to install the entire application, including the runtime assemblies, on the target computer. However, if multiple applications on the same computer use Telerik OpenAccess ORM application blocks, you must install a copy of the assemblies in each application's folder hierarchy. You can deploy the complete content of the Telerik OpenAccess ORM \bin installation folder together with your application (you will need to put everything in the same directory as your executable). Depending on the backend database used you can remove some of the files that are given below.
The assemblies and their functions are listed below:
- Telerik.OpenAccess.dll - this assembly contains the API classes.
- Telerik.OpenAccess.Config.dll - this assembly contains the classes used to load the Telerik OpenAccess ORM specific configuration file settings.
- Telerik.OpenAccess.Runtime.dll - this assembly implements all services available through the API assembly. It contains the database-specific classes used for accessing all supported databases (MS SQL2005 Server, Oracle (via ODP .NET), MySQL, Advantage Database Server (ADS), SQL Anywhere, SQL Azure, Microsoft SQL CE and Firebird included).
- Telerik.OpenAccess.35.Extensions.dll - this assembly contains the LINQ implementation for Telerik OpenAccess ORM (see the LINQ example, which demonstrates the OpenAccess ORM support for LINQ)
||Telerik.OpenAccess.35.Extensions.dll needs Microsoft .NET Framework 3.5 version or later runtime system installed.|
- Telerik.OpenAccess.Web.dll - contains components that can be used in web applications (e.g. OpenAccessDataSource).
- Telerik.OpenAccess.Windows.dll - contains components that can be used in windows applications (e.g. ObjectView and ObjectProvider).
- MySql.Data.dll - this assembly contains the backend-specific implementation for MySQL.
- policy.[version major].[version minor].Telerik.OpenAccess.dll - this assembly is the publisher policy file that redirects all binding requests of older versions of OpenAccess to the current one. It is the compiled version of the file OpenAccess.20_PublisherPolicy.cfg (also provided).
- policy.[version major].[version minor].Telerik.OpenAccess.Runtime.dll - this assembly is the publisher policy file that redirects all binding requests of older versions of Telerik.OpenAccess.Runtime to the current one. It is the compiled version of the file Telerik.OpenAccess.Runtime20_PublisherPolicy.cfg (also provided).
||It is recommended that you include all of these assemblies—except the policy assemblies—directly with your application and not use the global assembly cache (GAC). |
All the assemblies provided with the Telerik OpenAccess ORM are strong named, which provides versioning and naming protection. This means that the name of the binary code is guaranteed to be unique and that the versions being loaded are the ones intended to be used with the application. Because the application block assemblies are strong named, you can install them in the global assembly cache, where they can be shared by multiple applications on the computer.
The Telerik OpenAccess ORM installation package includes compiled assemblies. Every release of Telerik OpenAccess ORM has an increased version number for all assemblies except for Telerik.OpenAccess.Config.dll.
||It is not recommended that you use the Telerik OpenAccess ORM namespaces because it makes it difficult to identify the source of the code. Instead, you should choose a root namespace that meets your own coding and versioning standards.|
Microsoft .NET Framework 2.0 assemblies can be signed using any mechanism, including signing with both .snk and .pfx files. Also, both the AssemblyKeyFile attribute and the AssemblyKeyName attribute are supported. However, delayed signing is not supported. To sign an assembly with a strong name, you must have a public/private key pair. For more information, see Strong-Named Assemblies and Versioning Tutorial.