OleDbEnumerator.GetRootEnumerator メソッド

.NET Framework クラス ライブラリ リファレンス

OleDbEnumerator.GetRootEnumerator メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

OleDbEnumerator クラスのインスタンスを要求せずに、現在インストールされている OLE DB プロバイダに関する情報を格納している OleDbDataReader を返します。

名前空間: System.Data.OleDb
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Shared Function GetRootEnumerator
 As OleDbDataReader

Visual Basic (使用法)

Dim returnValue As OleDbDataReader

returnValue = OleDbEnumerator.GetRootEnumerator

C#

public static OleDbDataReader GetRootEnumerator
 ()

C++

public:
static OleDbDataReader^ GetRootEnumerator ()

J#

public static OleDbDataReader GetRootEnumerator
 ()

JScript

public static function GetRootEnumerator
 () : OleDbDataReader

戻り値
参照できる OLE DB プロバイダに関する情報を格納している OleDbDataReader を返します。

例外

例外の種類	条件
InvalidCastException	プロバイダが ISourcesRowset をサポートしていません。
OleDbException	基になるプロバイダで例外が発生しました。

解説

このメソッドで返されるリーダーには、次の列が含まれます。すべての列には文字列が格納されます。

列の序数	列	説明
0	SOURCES_NAME	ネイティブな OLEDB データ ソースまたは列挙子の不変名。
1	SOURCES_PARSENAME	ネイティブな COM インターフェイスである IParseDisplayName を使用してモニカに変換できる、判読可能な名前。ネイティブな OLE DB ソースの行セットから返される SOURCES_PARSENAME 列に対応します。
2	SOURCES_DESCRIPTION	ネイティブな OLE DB データ ソースの説明。ネイティブな OLE DB ソースの行セットから返される SOURCES_DESCRIPTION 列に対応します。
3	SOURCES_TYPE	Binder (0)、DataSource_MDP (1)、DataSource_TDP (2)、または Enumerator (3) の列挙体メンバの 1 つ。これらは、ネイティブな OLE DB ソースの行セットの SOURCES_TYPE 列に返される値に対応します。
4	SOURCES_ISPARENT	列挙子だけに適用できます。true の場合、GetSourcesRowset が呼び出されたのと同じ列挙子にエントリが適用されることを示します。つまり、サブ列挙体にも含まれます。ネイティブな OLE DB ソースの行セットの SOURCES_ISPARENT 列に対応します。
5	SOURCES_CLSID	ネイティブな COM インターフェイスである IParseDisplayName を使用してモニカに変換できる、判読可能な名前。ネイティブな OLE DB ソースの行セットから返される SOURCES_CLSID 列に対応します。

使用例

次のコンソール アプリケーションは、参照できるすべての OLE DB プロバイダに関する情報を取得し、その情報をコンソール ウィンドウに表示します。

Visual Basic

Imports System.Data
Imports System.Data.OleDb

Module Module1

  Sub Main()
    Dim enumerator As New
 OleDbEnumerator
    Dim reader As OleDbDataReader = OleDbEnumerator.GetRootEnumerator()

    DisplayData(reader)

    Console.WriteLine("Press any key to continue.")
    Console.ReadKey()
  End Sub

  Private Sub DisplayData(ByVal
 reader As OleDbDataReader)
    While reader.Read()
      For i As Integer =
 0 To reader.FieldCount - 1
        Console.WriteLine("{0} = {1}", _
         reader.GetName(i), reader.GetValue(i))
      Next
      Console.WriteLine("==================================")
    End While

  End Sub
End Module

C#

using System;
using System.Data;
using System.Data.OleDb;

class Program
{
 static void Main()
 {
   OleDbDataReader reader = OleDbEnumerator.GetRootEnumerator();

   DisplayData(reader);

   Console.WriteLine("Press any key to continue.");
   Console.ReadKey();
 }

 static void DisplayData(OleDbDataReader reader)
 {
   while (reader.Read())
   {
     for (int i = 0; i < reader.FieldCount;
 i++)
     {
       Console.WriteLine("{0} = {1}",
        reader.GetName(i), reader.GetValue(i));
     }
     Console.WriteLine("==================================");
   }
 }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
OleDbEnumerator クラス
OleDbEnumerator メンバ
System.Data.OleDb 名前空間