Using the Caché Managed Provider for .NET - InterSystems ...

More documents

Recommendations

Info

Using Caché ADO Provider Classes4.1 Introduction to ADO Provider ClassesA project using the Caché ADO Provider classes can be quite simple. Here is a complete, workingconsole program that opens and reads an item from the Sample.Person database:using System;using InterSystems.Data.CacheClient;using InterSystems.Data.CacheTypes;namespace TinySpace {class TinyProvider {[STAThread]static void Main(string[] args) {}CacheConnection CacheConnect = new CacheConnection();CacheConnect.ConnectionString = "Server = localhost; "+ "Port = 1972; " + "Namespace = SAMPLES; "+ "Password = SYS; " + "User ID = _SYSTEM;";CacheConnect.Open();string SQLtext = "SELECT * FROM Sample.Person WHERE ID = 1";CacheCommand Command = new CacheCommand(SQLtext, CacheConnect);CacheDataReader Reader = Command.ExecuteReader();while (Reader.Read()) {Console.WriteLine("TinyProvider output: \r\n "+ Reader[Reader.GetOrdinal("ID")] + ": "+ Reader[Reader.GetOrdinal("Name")]);};Reader.Close();Command.Dispose();CacheConnect.Close();} // end Main()} // end class TinyProviderThis project contains the following important features:• The Using statements provide access to the CacheClient assembly:using InterSystems.Data.CacheClient;using InterSystems.Data.CacheTypes;• The CacheConnection object is used to create and open a connection to the Caché SAMPLESnamespace:CacheConnection CacheConnect = new CacheConnection();CacheConnect.ConnectionString = "Server = localhost; "+ "Port = 1972; " + "Namespace = SAMPLES; "+ "Password = SYS; " + "User ID = _SYSTEM;";CacheConnect.Open();• The CacheCommand object uses the CacheConnection object and an SQL statement to open theinstance of Sample.Person that has an ID equal to 1.string SQLtext = "SELECT * FROM Sample.Person WHERE ID = 1";CacheCommand Command = new CacheCommand(SQLtext, CacheConnect);20 Using the Caché Managed Provider for .NET
• The CacheDataReader object is used to access the data items in the row:CacheDataReader Reader = Command.ExecuteReader();while (Reader.Read()) {Console.WriteLine("TinyProvider output: \r\n "+ Reader[Reader.GetOrdinal("ID")] + ": "+ Reader[Reader.GetOrdinal("Name")]);};Using CacheCommand and CacheDataReader4.1.1 Overview of Caché ADO Provider ClassesThe following classes are Caché-specific versions of the standard ADO Provider classes:• CacheConnection — Represents the connection between your application and the databases in aspecified Caché namespace. Use of CacheConnection objects is described in detail in Connectingto the Caché Database.• CacheCommand — Encapsulates an SQL statement or stored procedure to be executed againstdatabases in the namespace specified by a CacheConnection.• CacheDataReader — Provides the means to fetch the resultset specified by a CacheCommand. ACacheDataReader object provides quick forward-only access to the resultset, but is not designedfor random access.• CacheDataAdapter — Encapsulates a resultset that is mapped to data in the namespace specifiedby a CacheConnection. It is used to fill an ADO DataSet and to update the Caché database, providingan effective random access connection to the resultset.4.2 Using CacheCommand andCacheDataReaderSimple read-only queries can be performed using only CacheCommand and CacheDataReader. Likeall database transactions, such queries also require an open CacheConnection object.In this example, an SQL query string is passed to a new CacheCommand object, which will use theexisting connection:string SQLtext = "SELECT * FROM Sample.Person WHERE ID < 10";CacheCommand Command = new CacheCommand(SQLtext, CacheConnect);Results of the query are returned in a CacheDataReader object. Properties are accessed by referringto the names of columns specified in the SQL statement.Using the Caché Managed Provider for .NET 21
Page 1 and 2: Using the Caché ManagedProvider fo
Page 3 and 4: Table of Contents1 The Caché Manag
Page 5 and 6: List of FiguresCaché .NET Binding
Page 7 and 8: 1The Caché Managed ProviderSolutio
Page 9 and 10: Caché .NET Binding Client/Server A
Page 11: The Caché .NET Sample ProgramsNote
Page 14 and 15: Setting Up the Caché Managed Provi
Page 16 and 17: Setting Up the Caché Managed Provi
Page 18 and 19: Connecting to the Caché DatabaseTh
Page 20 and 21: Connecting to the Caché DatabaseIn
Page 22 and 23: Connecting to the Caché Database3.
Page 24: Connecting to the Caché DatabaseNa
Page 29: Using TransactionsCacheDataReader r
Page 32 and 33: Using Caché Proxy ClassesNote:The
Page 34 and 35: Using Caché Proxy Classes• Addin
Page 36 and 37: Using Caché Proxy Classes• Appli
Page 38 and 39: Using Caché Proxy Classes5.2.3 Gen
Page 40 and 41: Using Caché Proxy ClassesInterSyst
Page 42 and 43: Using Caché Proxy Classes• Save(
Page 44 and 45: Using Caché Proxy Classesstring pe
Page 46 and 47: Using Caché Proxy ClassesFor a wor
Page 48 and 49: Using Caché Proxy Classesstatic Sy
Page 50 and 51: Caché Managed Provider Class Refer
Page 52 and 53: Caché Managed Provider Class Refer
Page 54: Caché Managed Provider Class Refer

Using the Caché Managed Provider for .NET - InterSystems ...

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?