项目
04/01/2012

使用 AdomdDataReader 检索数据

检索分析数据时，AdomdDataReader 对象可使开销和交互功能之间实现较好的平衡。AdomdDataReader 对象将从分析数据源检索只读、只进的平展数据流。此未经缓冲的数据流使过程逻辑能够有效地按顺序处理分析数据源的结果。当检索大量数据用于显示时，使用 AdomdDataReader 是一个不错的选择，因为这些数据未在内存中缓存。

AdomdDataReader 还可通过在数据可用后随即对数据进行检索（而不是等待返回查询的完整结果）来提高应用程序的性能。AdomdDataReader 还可减少系统开销，因为默认情况下，此读取器一次仅在内存中存储一行。

优化性能的代价在于 AdomdDataReader 对象所提供的有关已检索数据的信息少于其他数据检索方法所提供的信息。AdomdDataReader 对象不支持用于表示数据或元数据的大型对象模型，此对象模型也不允许使用更复杂的分析功能，例如单元写回。但是，AdomdDataReader 对象提供一组用于检索单元集数据的强类型方法，并且还提供一种用于检索表格格式单元集元数据的方法。此外，AdomdDataReader 还实现了 IDbDataReader 接口以支持数据绑定，并且支持使用 SelectCommand 方法从 Microsoft .NET Framework 类库的 System.Data 命名空间检索数据。

使用 AdomdDataReader 检索数据

若要使用 AdomdDataReader 对象检索数据，请按以下步骤操作：

创建对象的新实例。

若要创建 AdomdDataReader 类的新实例，请调用 AdomdCommand 对象的 Execute 或 ExecuteReader 方法。
检索数据。

当命令运行查询时，ADOMD.NET 将以 Resultset 格式（如 XML for Analysis 规范中所述的一种表格格式）返回结果，从而对 AdomdDataReader 对象的数据进行平展处理。在考虑分析数据的可变维数的情况下对该数据进行查询时，表格格式并不常用。

在您使用下列方法之一请求表格结果之前，ADOMD.NET 会将这些表格结果存储在客户端的网络缓冲区中：
- 调用 AdomdDataReader 对象的 Read 方法。
  
  Read 方法可从查询结果中获取行。然后，可以将列的名称或序号引用传递到 Item 属性，以访问返回行的每列。例如，当前行中的第一列名为 ColumnName。然后，reader[0].ToString() 或 reader["ColumnName"].ToString() 将返回当前行中第一列的内容。
- 调用下列类型化取值函数方法之一：
  
  AdomdDataReader 可提供一系列类型化取值函数方法，这些方法用于访问本机数据类型的列值。如果您知道列值的基础数据类型，则类型化取值函数方法可减少检索列值时所需的类型转换量，从而提供最佳性能。
  
  一些可用的类型化取值函数方法包括 GetDateTime、GetDouble 和 GetInt32。有关类型化取值函数方法的完整列表，请参阅 AdomdDataReader。
关闭读取器。

使用完 AdomdDataReader 对象后，应始终调用 Close 方法。AdomdDataReader 对象实例处于打开状态时，该 AdomdDataReader 会以独占方式使用 AdomdConnection。您将无法对 AdomdConnection 的实例运行任何命令，包括创建其他 AdomdDataReader 或 System.Xml.XmlReader，直到您关闭原始的 AdomdDataReader 为止。

使用 AdomdDataReader 检索数据的示例

下面的代码示例将循环执行 AdomdDataReader 对象，然后以字符串形式返回每一行中的前两个值。

If Reader.HasRows Then
    Do While objReader.Read()
        Console.WriteLine(vbTab & "{0}" & vbTab & "{1}", _
            objReader.GetString(0), objReader.GetString(1))
    Loop
Else
  Console.WriteLine("No rows returned.")
End If

objReader.Close()

if (objReader.HasRows)
  while (objReader.Read())
    Console.WriteLine("\t{0}\t{1}", _
        objReader.GetString(0), objReader.GetString(1));
else
  Console.WriteLine("No rows returned.");

objReader.Close();

使用 AdomdDataReader 检索元数据

打开 AdomdDataReader 对象的实例后，可使用 GetSchemaTable 方法检索有关当前记录集的架构信息或元数据。GetSchemaTable 将返回用当前记录集的架构信息填充的 DataTable 对象。在 DataTable 中，记录集的每一列都将占一行。架构表行的每个列都映射到在单元集中返回的列的属性，其中 ColumnName 为该属性的名称，列的值为该属性的值。

使用 AdomdDataReader 检索元数据的示例

下面的代码示例将写出 AdomdDataReader 对象的架构信息。

Dim schemaTable As DataTable = objReader.GetSchemaTable()

Dim objRow As DataRow
Dim objColumn As DataColumn

For Each objRow In schemaTable.Rows
  For Each objColumn In schemaTable.Columns
    Console.WriteLine(objColumn.ColumnName & " = " & objRow(objColumn).ToString())
  Next
  Console.WriteLine()
Next
DataTable schemaTable = objReader.GetSchemaTable();

foreach (DataRow objRow in schemaTable.Rows)
{
  foreach (DataColumn objColumn in schemaTable.Columns)
    Console.WriteLine(objColumn.ColumnName + " = " + objRow[objColumn]);
  Console.WriteLine();
}