DataTableReader.GetDataTypeName メソッド

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

DataTableReader.GetDataTypeName メソッド

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

指定した列のデータ型を示す文字列を取得します。

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

Visual Basic (宣言)

Public Overrides Function
 GetDataTypeName ( _
    ordinal As Integer _
) As String

Visual Basic (使用法)

Dim instance As DataTableReader
Dim ordinal As Integer
Dim returnValue As String

returnValue = instance.GetDataTypeName(ordinal)

C#

public override string GetDataTypeName (
    int ordinal
)

C++

public:
virtual String^ GetDataTypeName (
    int ordinal
) override

J#

public String GetDataTypeName (
    int ordinal
)

JScript

public override function GetDataTypeName (
    ordinal : int
) : String

パラメータ

ordinal

列の 0 から始まる序数。

戻り値
列のデータ型を示す文字列。

例外

例外の種類	条件
ArgumentOutOfRangeException	渡されたインデックスが 0 から FieldCount - 1 の範囲にありません。
InvalidOperationException	閉じている DataTableReader の列を読み取るかアクセスしようとしました。

解説

GetDataTypeName メソッドは、プロバイダ固有の型ではなく、常に基になる DataColumn の型を返します。

使用例

次に示すコンソール アプリケーションでは、単純な DataTable から取得したフィールドとそのデータ型名の一覧が表示されます。

Visual Basic

Private Sub TestGetTypeName()
   Dim table As DataTable = GetCustomers()
   Using reader As New DataTableReader(table)
      For i As Integer =
 0 To reader.FieldCount - 1
         Console.WriteLine("{0}: {1}", _
            reader.GetName(i), reader.GetDataTypeName(i))
      Next
   End Using

   Console.WriteLine("Press Enter to finish.")
   Console.ReadLine()
End Sub

Private Function GetCustomers() As
 DataTable
   ' Create sample Customers table, in order
   ' to demonstrate the behavior of the DataTableReader.
   Dim table As New DataTable

   ' Create two columns, ID and Name.
   Dim idColumn As DataColumn = table.Columns.Add("ID",
 _
     GetType(Integer))
   table.Columns.Add("Name", GetType(String))

   ' Set the ID column as the primary key column.
   table.PrimaryKey = New DataColumn() {idColumn}

   table.Rows.Add(New Object() {1, "Mary"})
   table.Rows.Add(New Object() {2, "Andy"})
   table.Rows.Add(New Object() {3, "Peter"})
   table.Rows.Add(New Object() {4, "Russ"})
   Return table
End Function

C#

private static void TestGetTypeName()
{
    DataTable table = GetCustomers();
    using (DataTableReader reader = new DataTableReader(table))
    {
        for (int i = 0; i < reader.FieldCount;
 i++)
        {
            Console.WriteLine("{0}: {1}", reader.GetName(i), 
                reader.GetDataTypeName(i));
        }
    }
    Console.WriteLine("Press Enter to finish.");
    Console.ReadLine();
}

private static DataTable GetCustomers()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();
    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID", typeof(int));
    table.Columns.Add("Name", typeof(string ));
    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };

    table.Rows.Add(new object[] { 1, "Mary" });
    table.Rows.Add(new object[] { 2, "Andy" });
    table.Rows.Add(new object[] { 3, "Peter" });
    table.Rows.Add(new object[] { 4, "Russ" });
    return table;
}

コンソール ウィンドウには次の結果が表示されます。

ID: Int32
Name: String

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0

参照

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