如何通过使用 DataReader GetSchemaTable 方法和 Visual C# 中检索列的架构。NET

文章翻译 文章翻译
文章编号: 310107 - 查看本文应用于的产品
本文的发布号曾为 CHS310107
展开全部 | 关闭全部

本文内容

概要

本文演示如何使用 ado DataReader对象的GetSchemaTable方法。NET 中检索列的架构信息。另一个名称列的架构是其字段属性。列模式信息包含列的以下信息:
  • 名称
  • 数据类型
  • 大小
  • 该列是否是主键字段
  • 该列是否是自动编号 (自动增量)字段
GetSchemaTable方法返回包含的列模式将DataReader数据表属性。数据表包含每个字段在结果集中的一行。每一列在结果集中的字段的属性映射。数据表列的ColumnName属性是属性的字段,如ColumnName数据类型ColumnSizeIsKeyColumnIsAutoIncrement属性的名称。数据表列的值是属性的该字段,如名字字段值为ColumnName属性的值。
注意要获取主键信息,其中包括域是否是主键的一部分,是一个自动增量字段,您必须设置为CommandBehavior.KeyInfoDataReaderCommandBehavior值。

您可以使用任一 OLE DB 使用GetSchemaTable方法。NET 提供程序或 SQL。NET提供程序。OleDbDataReader.GetSchemaTable方法映射的 OLE DB IColumnsRowset::GetColumnsRowset方法。SqlDataReader.GetSchemaTable方法不使用 OLE DB 提供程序层。

注意,除非您明确地使用GetSchemaTable方法, DataReader不返回列的架构。此外,如果您要检索的列模式使用GetSchemaTable ,您无法更新DataReaderDataReader始终检索数据的只读、 只进流数据库。

何时使用 GetSchemaTable 方法

  • SqlConnection对象不支持检索架构信息的 SQL Server在类似于OleDbConnection对象的GetOleDbSchemaTable方法的方法。SqlDataReader类的GetSchemaTable方法,可以轻松获取列模式SQL Server 中的信息。
  • 虽然OleDbConnection对象的GetOleDbSchemaTable方法可以返回数据库、 表和列的架构信息,您可能会发现DataReader对象的GetSchemaTable方法是易于使用,如果您要检索仅列架构信息。
  • 您可以使用GetSchemaTable方法来创建新的数据表时,自定义的列名称和其他基于现有数据表属性架构列属性。有关代码示例演示如何使用GetSchemaTable来定义新表,请参阅"Visual Studio 示例: Fitch和 Mather 7.0 运行 SQL 查询"Microsoft Visual Studio 中的主题。NET 联机帮助文档。

检索列的 OLE DB 架构。NET 提供程序

此示例列出列 (域的架构的信息属性) 的 SQL Server 罗斯文中的雇员表数据库。

请注意,当您使用 OLE DB。NET 提供程序,则使用GetSchemaTableOleDbDataReader对象的方法。
  1. 开始 Visual Studio。NET,并创建新 Visual C#控制台应用程序项目。Class1.cs 是默认创建的。
  2. 打开代码窗口的 Class1。粘贴以下代码在上面的命名空间声明的代码窗口的顶部:
    using System.Data;
    using System.Data.OleDb;
    					
  3. 在代码窗口中,将粘贴的Main函数中添加以下代码:
    OleDbConnection cn = new OleDbConnection();
    OleDbCommand cmd = new OleDbCommand();
    DataTable schemaTable; 
    OleDbDataReader myReader; 
    			 
    //Open a connection to the SQL Server Northwind database.
    cn.ConnectionString = "Provider=SQLOLEDB;Data Source=server;User ID=login;
                           Password=password;Initial Catalog=Northwind";
    cn.Open();
    
    //Retrieve records from the Employees table into a DataReader.
    cmd.Connection = cn;
    cmd.CommandText = "SELECT * FROM Employees";
    myReader = cmd.ExecuteReader(CommandBehavior.KeyInfo); 
    
    //Retrieve column schema into a DataTable.
    schemaTable = myReader.GetSchemaTable();
    
    //For each field in the table...
    foreach (DataRow myField in schemaTable.Rows){
        //For each property of the field...
        foreach (DataColumn myProperty in schemaTable.Columns) {
    	//Display the field name and value.
    	Console.WriteLine(myProperty.ColumnName + " = " + myField[myProperty].ToString());
        }
        Console.WriteLine();
    
        //Pause.
        Console.ReadLine();
    }
    
    //Always close the DataReader and connection.
    myReader.Close();
    cn.Close();
    					
  4. 修改要正确地连接到您的 SQL Server 的连接字符串属性的参数计算机。
  5. 按 F5 键编译并运行该项目。请注意控制台窗口中列出的每个字段的属性。
  6. 按 ENTER 键以滚动列表,结束控制台应用程序,并返回到集成开发环境(IDE)。

检索列与 SQL 的架构。NET 提供程序

此示例列出列 (域的架构的信息属性) 的 SQL Server 罗斯文中的雇员表数据库。

请注意,当您使用 SQL。NET 提供程序,您可以使用GetSchemaTableSqlDataReader对象的方法。
  1. 开始 Visual Studio。NET,并创建新 Visual C#控制台应用程序项目。Class1.cs 是默认创建的。
  2. 打开代码窗口的 Class1。粘贴以下代码在上面的命名空间声明的代码窗口的顶部:
    using System.Data;
    using System.Data.SqlClient;
    					
  3. 在代码窗口中,将粘贴的Main函数中添加以下代码:
    SqlConnection cn = new SqlConnection();
    SqlCommand cmd = new SqlCommand();
    DataTable schemaTable; 
    SqlDataReader myReader; 
    			 
    //Open a connection to the SQL Server Northwind database.
    cn.ConnectionString = "Data Source=server;User ID=login;
                           Password=password;Initial Catalog=Northwind";
    cn.Open();
    
    //Retrieve records from the Employees table into a DataReader.
    cmd.Connection = cn;
    cmd.CommandText = "SELECT * FROM Employees";
    myReader = cmd.ExecuteReader(CommandBehavior.KeyInfo);
    
    //Retrieve column schema into a DataTable.
    schemaTable = myReader.GetSchemaTable();
    
    //For each field in the table...
    foreach (DataRow myField in schemaTable.Rows){
        //For each property of the field...
        foreach (DataColumn myProperty in schemaTable.Columns) {
    	//Display the field name and value.
    	Console.WriteLine(myProperty.ColumnName + " = " + myField[myProperty].ToString());
        }
        Console.WriteLine();
    
        //Pause.
        Console.ReadLine();
    }
    
    //Always close the DataReader and connection.
    myReader.Close();
    cn.Close();
    					
  4. 修改要正确地连接到您的 SQL Server 的连接字符串属性的参数计算机。
  5. 按 f5 键编译并运行该项目。请注意,在控制台窗口中列出的每个字段的属性。
  6. 按 ENTER 键以滚动列表,结束控制台应用程序,并返回到 IDE 中。

参考

有关DataReaderGetSchemaTable方法的详细信息,请参阅 Visual Studio 中的下列主题。NET 联机帮助文档:
使用 DataReader 检索数据

IDataReader.GetSchemaTable 方法

注意: 本主题中包括的列中的完整列表返回的的数据表

OleDbDataReader.GetSchemaTable 方法

SqlDataReader.GetSchemaTable 方法
有关使用OleDbConnection对象的GetOleDbSchemaTable方法,以检索架构信息的其他信息,请单击的文章编号,下面,以查看 Microsoft 知识库中相应的文章:
309681 如何使用 GetOleDbSchemaTable 和 Visual C# 中检索架构信息。NET

属性

文章编号: 310107 - 最后修改: 2012年6月12日 - 修订: 1.0
这篇文章中的信息适用于:
  • Microsoft ADO.NET 1.1
  • Microsoft Visual C# .NET 2003 标准版
  • Microsoft Visual C# .NET 2002 标准版
关键字:?
kbdatabase kbhowtomaster kbsqlclient kbsystemdata kbmt KB310107 KbMtzh
机器翻译
注意:这篇文章是由无人工介入的微软自动的机器翻译软件翻译完成。微软很高兴能同时提供给您由人工翻译的和由机器翻译的文章, 以使您能使用您的语言访问所有的知识库文章。然而由机器翻译的文章并不总是完美的。它可能存在词汇,语法或文法的问题,就像是一个外国人在说中文时总是可能犯这样的错误。虽然我们经常升级机器翻译软件以提高翻译质量,但是我们不保证机器翻译的正确度,也不对由于内容的误译或者客户对它的错误使用所引起的任何直接的, 或间接的可能的问题负责。
点击这里察看该文章的英文版: 310107
Microsoft和/或其各供应商对于为任何目的而在本服务器上发布的文件及有关图形所含信息的适用性,不作任何声明。 所有该等文件及有关图形均"依样"提供,而不带任何性质的保证。Microsoft和/或其各供应商特此声明,对所有与该等信息有关的保证和条件不负任何责任,该等保证和条件包括关于适销性、符合特定用途、所有权和非侵权的所有默示保证和条件。在任何情况下,在由于使用或运行本服务器上的信息所引起的或与该等使用或运行有关的诉讼中,Microsoft和/或其各供应商就因丧失使用、数据或利润所导致的任何特别的、间接的、衍生性的损害或任何因使用而丧失所导致的之损害、数据或利润不负任何责任。

提供反馈

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com