OleDbEnumerator.GetEnumerator メソッド

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

OleDbEnumerator.GetEnumerator メソッド

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

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

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

Visual Basic (宣言)

Public Shared Function GetEnumerator
 ( _
    type As Type _
) As OleDbDataReader

Visual Basic (使用法)

Dim type As Type
Dim returnValue As OleDbDataReader

returnValue = OleDbEnumerator.GetEnumerator(type)

C#

public static OleDbDataReader GetEnumerator
 (
    Type type
)

C++

public:
static OleDbDataReader^ GetEnumerator (
    Type^ type
)

J#

public static OleDbDataReader GetEnumerator
 (
    Type type
)

JScript

public static function GetEnumerator
 (
    type : Type
) : OleDbDataReader

パラメータ

type

Type。

戻り値
指定された OLE DB 列挙子を使用して、要求された OLE DB プロバイダに関する情報を格納している OleDbDataReader を返します。

例外

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

解説

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

列の序数	列	説明
0	SOURCES_NAME	ネイティブな OLE DB データ ソースまたは列挙子の不変名。
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 列に対応します。

OLE DB には、MSDAENUM、MSDASQL Enumerator、SQLNCLI Enumerator、SQLOLEDB Enumerator などの複数の列挙子コンポーネントが用意されています。列挙子コンポーネントの解説とその使用方法については、「OLE DB Programmer's Reference」を参照してください。

使用例

次のコンソール アプリケーションは、MSDAENUM コンポーネントを使用して、すべての 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.GetEnumerator(Type.GetTypeFromProgID("MSDAENUM"))

    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.GetEnumerator(Type.GetTypeFromProgID("MSDAENUM"));

   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 名前空間