C# DataSet

2023-02-21

一、基本概念

  DataSet是ADO.NET的中心概念。可以把DataSet当成内存中的数据库,DataSet是不依赖于数据库的独立数据集合。所谓独立,就是说,即使断开数据链路,或者关闭数据库,DataSet依然是可用的,DataSet在内部是用XML来描述数据的,由于XML是一种与平台无关、与语言无关的数据描述语言,而且可以描述复杂关系的数据,比如父子关系的数据,所以DataSet实际上可以容纳具有复杂关系的数据,而且不再依赖于数据库链路。

  在典型的多层实现中,用于创建和刷新 DataSet 并依次更新原始数据的步骤包括:
  通过 DataAdapter 使用数据源中的数据生成和填充 DataSet 中的每个 DataTable。
  通过添加、更新或删除 DataRow 对象更改单个 DataTable 对象中的数据。
  调用 GetChanges 方法以创建只反映对数据进行的更改的第二个 DataSet。
  调用 DataAdapter 的 Update 方法,并将第二个 DataSet 作为参数传递。
  调用 Merge 方法将第二个 DataSet 中的更改合并到第一个中。
  针对 DataSet 调用 AcceptChanges。或者,调用 RejectChanges 以取消更改。需要注意的是:dataset所有数据都加载在内存上执行的,可以提高数据访问速度,提高硬盘数据的安全性。极大的改善了程序运行的速度和稳定性。
 
二、数据模型
  因为DataSet可以看做是内存中的数据库,也因此可以说DataSet是数据表的集合,它可以包含任意多个数据表(DataTable),而且每一 DataSet中的数据表(DataTable)对应一个数据源中的数据表(Table)或是数据视图(View)。数据表实质是由行(DataRow)和 列(DataColumn)组成的集合为了保护内存中数据记录的正确性,避免并发访问时的读写冲突,DataSet对象中的DataTable负责维护每一条记录,分别保存记录的初始状态和当前状态。从这里可以看出DataSet是与只能存放单张数据表的Recordset是截然不同的概念。
 
三、使用介绍
1、创建
  DataSet ds = new DataSet("DataSetName");
2、查看调用

  da.Fill(ds,"Orders");

  DataTable tbl = ds.Table[0];

  foreach(DataColumn col in tbl.Columns)

    Console.WriteLine(col.ColumnName);

3、查看SqlDataAdapter返回的数据

  DataRow对象

    DataTable tbl = ds.Table[0];

    DataRow row = tbl.Row[0];

    Console.WriteLine(row["OrderID"]);

  检查存储在DataRow中的数据

    DataTable tbl = row.Table;

    foreach(DataColumn col in tbl.Columns)

      Console.WriteLine(row[col]);

  检查DatTable中的DataRow对象

    foreach(DataRow row in tbl.Rows)

      DisplayRow(row);

4、校验DataSet中的数据

  校验DataColumn的属性:ReadOnly,AllowDBNull,MaxLength,Unique

  DataTable对象的Constrains集合:UiqueConstraints,Primarykey,ForeignkeyConstraints

  通常不必刻意去创建ForeignkeyConstraints,因为当在DataSet的两个DataTable对象之间创建关系时会创建一个。

  用SqlDataAdapter.Fill模式来检索模式信息

5、编写代码创建DataTable对象

  创建DataTable对象:

    DataTable tbl = new DataTable("TableName");

  将DataTable添加到DataSet对象的Table集合

    DataSet ds = new DataSet();

    DataTable tbl = new DataTable("Customers");

    ds.Tables.Add(tbl);

    DataSet ds = new DataSet();

    DataTable tbl = ds.Tables.Add("Customers");

    DataTable对象只能存在于至多一个DataSet对象中。如果希望将DataTable添加到多个DataSet中,就必须使用Copy方法或Clone方法。Copy方法创建一个与原DataTable结构相同并且包含相同行的新DataTable;Clone方法创建一个与原 DataTable结构相同,但没有包含任何行的新DataTable。

  为DataTable添加列

    DataTable tbl = ds.Tables.Add("Orders");

    DataColumn col =tbl.Columns.Add("OrderID",typeof(int));

    col.AllowDBNull= false;

    col.MaxLength= 5;

    col.Unique= true;

    tbl.PrimaryKey= new DataColumn[]{tbl.Columns["CustomersID"]};

    当设置主键时,AllowDBNull自动设置为False;

  处理自动增量列

    DataSet ds = new DataSet();

    DataTable tbl = ds.Tables.Add("Orders");

    DataColumn col = tbl.Columns.Add("OrderID",typeof(int));

    col.AutoIncrement= true;

    col.AutoIncrementSeed= -1;

    col.AutoIncrementStep= -1;

    col.ReadOnly= true;

  添加基于表达式的列

    tbl.Columns.Add("ItemTotal",typeof(Decimal),"Quantity*UnitPrice");

6、修改DataTable内容

  添加新DataRow

    DataRow row = ds.Tables["Customers"].NewRow();

    row["CustomerID"]= "ALFKI";

    ds.Tables["Customers"].Rows.Add(row);

    object[] aValues={"ALFKI","Alfreds","Anders","030-22222"};

    da.Tables["Customers"].LoadDataRow(aValues,false);

  修改当前行

    修改行的内容逼供内不会自动修改数据库中相应的内容,对行所做的修改被视为是随后将使用SqlDataAdapter对象来提交交给数据库的待定的更改。

    DataRow rowCustomer;

    rowCustomer= ds.Tables["Custoemrs"].Rows.Find("ANTON");

    if(rowCustomer== null)

    //没有查找客户

    else

    {

    rowCustomer["CompanyName"]="NewCompanyName";

    rowCustomer["ContactName"]="NewContactName";

    }

    //推荐使用这种方式

    DataRow rowCustomer;

    rowCustomer= ds.Tables["Custoemrs"].Rows.Find("ANTON");

    if(rowCustomer== null)

   //没有查找客户

    else

    {

    rowCustomer.BeginEdit();

     rowCustomer["CompanyName"]="NewCompanyName";

    rowCustomer["ContactName"]="NewContactName";

    rowCustomer.EndEdit();

    }

    //null表示不修改该列的数据

    obejct[] aCustomer ={null,"NewCompanyName","NewContactName",null}

    DataRow rowCustomer;

    rowCustomer= ds.Tables["Customers"].Rows.Find("ALFKI");

    rowCustomer.ItemArray= aCustomer;

  处理DataRow的空值

    //查看是否为空

    DataRow rowCustomer;

    rowCustomer= ds.Tables["Customers"].Rows.Find("ALFKI");

    if(rowCustomer.IsNull("Phone"))

      Console.WriteLine("It''''sNull");

    else

      Console.WriteLine("It''''snot Null");

    //赋予空值

    rowCustomer["Phone"]= DBNull.Value;

  删除DataRow

    DataRow rowCustomer;

    rowCustomer= ds.Tables["Customers"].Rows.Find("ALFKI");

    rowCustomer.Delete();

  清除DataRow

    DataRow rowCustomer = ds.Tables["Customers"].Rows.Find("ALFKI");

    rowCustomer.ItemArray= aCustomer;

    da.Tables["Customers"].Remove(rowCustomer);

    或者

    ds.Tables["Customers"].RemoveAt(intIndex);

  使用DataRow.RowState属性 :Unchanged,Detached,Added,Modified,Deleted

    privatevoid DemonstrateRowState()

    {

    // Run a function to create a DataTablewith one column.

    DataTable myTable = MakeTable();

    DataRow myRow;

    // Create a new DataRow.

    myRow = myTable.NewRow();

    // Detached row.

    Console.WriteLine("New Row " +myRow.RowState);

    myTable.Rows.Add(myRow);

    // New row.

    Console.WriteLine("AddRow " +myRow.RowState);

    myTable.AcceptChanges();

    // Unchanged row.

    Console.WriteLine("AcceptChanges" + myRow.RowState);

    myRow["FirstName"] ="Scott";

    // Modified row.

    Console.WriteLine("Modified " +myRow.RowState);

    myRow.Delete();

    // Deleted row.

    Console.WriteLine("Deleted " +myRow.RowState);

    }

  检查DataRow中的挂起更改

    DataRow rowCustomer;

    rowCustomer= ds.Tables["Customers"].Rows.Find("ALFKI");

    rowCustomer["CompanyName"]= "NewCompanyName";

    string strNewCompanyName,strOldCompanyName;

    Console.WriteLine(rowCustomer["CompanyName",DataRowVersion.Current]);

    Console.WriteLine(rowCustomer["CompanyName",DataRowVersion.Original]);

  遍历DataSet

    foreach(DataTable dt in dataSet.Tables)

    foreach(DataRow dr in dt.Rows)

    foreach(DataColumn dc in dr.Table.Columns)

      Console.WriteLine(dr[dc]);

四、属性方法

  1、DataSet

    属性

      CaseSensitive:用于控制DataTable中的字符串比较是否区分大小写。

      DataSetName:当前DataSet的名称。如果不指定,则该属性值设置为"NewDataSet"。如果将DataSet内容写入XML文件,DataSetName是XML文件的根节点名称。

      DesignMode:如果在设计时使用组件中的DataSet,DesignMode返回True,否则返回False。

      HasErrors:表示DataSet中 的DataRow对象是否包含错误。如果将一批更改提交给数据库并将DataAdapter对象的ContinueUpdateOnError属性设置为 True,则在提交更改后必须检查DataSet的HasErrors属性,以确定是否有更新失败。

      NameSpace和Prefix:指定XML命名空间和前缀

      Relations:返回一个DataRelationCollection对象。

      Tables:检查现有的DataTable对象。通过索引访问DataTable有更好的性能。

    方法

      AcceptChanges和RejectChanges: 接受或放弃DataSet中所有挂起更改。调用AcceptChanges时,RowState属性值为Added或Modified的所有行的 RowState属性都将被设置为UnChanged.任何标记为Deleted的DataRow对象将从DataSet中删除。调用 RejectChanges时,任何标记为Added的DataRow对象将会被从DataSet中删除,其他修改过的DatRow对象将返回前一状态。

      Clear:清除DataSet中所有DataRow对象。该方法比释放一个DataSet然后再创建一个相同结构的新DataSet要快。

      Clone和Copy:使用Copy方法会创建与原DataSet具有相同结构和相同行的新DataSet。使用Clone方法会创建具有相同结构的新DataSet,但不包含任何行。

      GetChanges:返回与原DataSet对象具有相同结构的新DataSet,并且还包含原DataSet中所有挂起更改的行。

      GetXml和GetXmlSchema:使用GetXml方法得到由DataSet的内容与她的架构信息转换为XML格式后的字符串。如果只希望返回架构信息,可以使用GetXmlSchema。

      HasChange:表示DataSet中是否包含挂起更改的DataRow对象。

      Merge:从另一个DataSet、DataTable或现有DataSet中的一组DataRow对象载入数据。

      ReadXml和WriteXml:使用ReadXml方法从文件、TextReader、数据流或者XmlReader中将XML数据载入DataSet中。

      Reset:将DataSet返回为未初始化状态。如果想放弃现有DataSet并且开始处理新的DataSet,使用Reset方法比创建一个DataSet的新实例好。

    事件

      MergeFailed:在DataSet的Merge方法发生一个异常时触发。

  2、DataTable

    属性

    方法

    事件

      ColumnChanged:在列的内容被改变之后触发

      ColumnChangding:在列的内容被改变之前触发

      RowChanged,RowChanging,RowDeleted,RowDeleting。

  3、DataColumn

    属性

  4、DataRow

    属性

      HasError:确定行是否包含错误。

      Item:通过指定行的列数,列的名称或DataColumn对象本身,访问列的内容。

      ItemArray:获取或设置行中所有列的值。

      RowError:返回一个包含行错误信息的字符串。

      RowState:返回DataRowState枚举中的值来表示行的当前状态。

      Table:返回DataRow对象所在的DataTable。

    方法

      AcceptChanges和RejectChanges:提交和放弃挂起更改。

      BeginEdit、CancelEdit、EndEdit

      ClearErrors:清除DataRow中所有的错误。

      Delete:Delete方法实际上并不从DataRow表的Row集合中删除该DataRow。当调用DataRow对象的Delete方法时,ADO.NET将该行标记为删除,之后调用SqlDataAdapter对象的Update方法来删除其在数据库中对应的行。

      如果希望彻底删除DataRow,可以调用Delete方法,接着再调用它的AccepteChanges方法,还可以使用DataRowCollection对象的Remove方法完成相同的任务。

      dataset ds =new datast();

      datatabletel =new datatable();

      ds..tables.add(tel);

      stringcode=ds.tables["tel"].rows[0][0].tostring();

五、用法示例

  DataSet的操作:

    DataSet ds=new DataSet();

    DataTable dt=new DataTable("newTable");

    ds.Tables.Add(dt);

    DataSet ds=new DataSet();

    DataTable dt=ds.Tables.Add("newTable");

    上述两种方法都可以在DataSet中添加一个DataTable,看需要而进行选择。添加DataTable后,需向其中添加行和列。

    DataSet ds=new DataSet();

    DataTabledt=ds.Tables.Add("newTables");

    DataColumn col=dt.Columns.Add("newColumn",typeof(int));

    col.AllowDBNull=false;

    col.MaxLength=4;

    col.Unique=true;

    上述代码向DataSet中的DataTable中添加名为”newColumn”,类型为int且不为空,最大长度为4和唯一性为真的列。

    dt.PrimaryKey=newDataColumn[]{dt.Columns["ID"]}

    这段代码是继续上面代码的,为一个DataTable中添加一个主键列,主键列是一个数据组,如有多个主键,只需在数组中添加一个列即可。如下:

    dt.PrimaryKey=newDataColumns[]{dt.Columns["OrderID"],dt.Columns["ProductID"]}

    添加外键:

    ForeignKeyConstraint fk;

    fk=newForeignKeyConstraint(ds.Tables["Customers"].Columns["CustomerID"],ds.Tables["Orders"].Columns["CustomerID"]);

    ds.Tables["Orders"].Constraints.Add(fk);

    上述代码假如已经为Cusomers表和Orders创建了主键,此句为添加外键约束。

    上述是根据Customers表和Orders表的CustomerID来创建约束。

    下面介绍修改DataRow中的内容:

    DataRow dr=ds.Tables["Customer"].Rows.Find("ANTON");

    if(dr==null)

    else

    {

    dr.BeginEdit();

    dr["CompanyName"]="newValue";

    dr["ContactName"]="newValue2";

    dr.EndEdit();

    }

    上面代码通过Row集合的Find方法来在DataTable中的行进行定位,找到"ANTON"行,再修改"ANTON"行中 CompanyName列和ContactName列的值。通过BeginEdit和EndEdit来缓存对行的修改,还可调用 CancelEdit为取消修改。

    判断某列是否为空值:

    DataRow dr=ds.Tables["Customers"].Rows.Find("aaa");

    if(dr.IsNull("ContactName");

    ..

    else

    dr["ContactName"]=DBNull.Value

    这里判断ContactName列是否为空,如果不是则为其赋空值,呵,很无厘头的做法,这里只为演示为列赋空值的做法。

    删除DataRow:

    有两种方法可以删除DataRow,Delete方法和Remove方法和RemoveAt方法。其区别是Delete方法实际上不是从 DataTable 中删除掉一行,而是将其标志为删除,仅仅是做个记号,而Remove方法则是真正的从DataRow中删除一行,RemoveAt方法是根本行的索引来删 除。列:

    DataRow dr=ds.Tables["table"].Rows.Find("a");

    ds.Tables["table"].Remove(dr);

    或

    ds.Tables["table"].Remove(index);

    dr 为"a"所在的行,查出后将其删除,index为 "a"所在的索引号。关于DataSet中的其用法,参照MSDN

    DataRow dr=ds.Tables["Customers"].Rows.Find("aaa");

    if(dr.IsNull("ContactName");

    ..

    else

    dr["ContactName"]=DBNull.Value

    这里判断ContactName列是否为空,如果不是则为其赋空值,这里只为演示为列赋空值的做法。

usingSystem.Data;

usingSystem;

usingSystem.Windows.Forms;

classDataT

{

static DataTable dt;// = new DataTable();

static DataSet ds;

static void method1()

{

dt = new DataTable("Name");

ds = new DataSet();

dt.Columns.Add(newDataColumn("ID", typeof(Int32)));

dt.Columns.Add(newDataColumn("Name", typeof(string)));

dt.Columns.Add(newDataColumn("Sex", typeof(string)));

dt.Columns.Add(newDataColumn("Addr", typeof(string)));

}

static void add(int id,string name,stringsex,string addr)

{

DataRow dr = dt.NewRow();

dr["id"] = id;

dr["Name"] = name;

dr["Sex"] = sex;

dr["Addr"] = addr;

dt.Rows.Add(dr);

}

static void Main()

{

DataT DT = new DataT();

method1();

add(100,"Join","Male","北京");

add(101,"Lily","feMale","北京");

add(102,"JIM","Male","北京");

ds.Tables.Add(dt);

foreach(DataRow dr in dt.Rows)

{

MessageBox.Show(dr["ID"].ToString()+ " " + dr["Name"].ToString() + " " +dr["Sex"].ToString() + " " +dr["Addr"].ToString(),"Message");

Console.WriteLine(dr["ID"].ToString()+ " " + dr["Name"].ToString()+ " " +dr["Sex"].ToString() + " " +dr["Addr"].ToString());

}

Try

{

foreach(DataTable dt2 in ds.Tables)

foreach(DataRow dr in dt2.Rows)

Console.WriteLine(dr["ID"].ToString()+ " " + dr["Name"].ToString() + " " + dr["Sex"].ToString()+ " " + dr["Addr"].ToString());

}

catch(Exception ex)

{

Console.WriteLine("dkfjksdjfk");

}

}

}

C# DataSet的相关教程结束。

《C# DataSet.doc》

下载本文的Word格式文档,以方便收藏与打印。