DataTable DataTable DataTable DataTable Class

定義

メモリ内データの 1 つのテーブルを表します。Represents one table of in-memory data.

public ref class DataTable : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, System::ComponentModel::ISupportInitializeNotification, System::Runtime::Serialization::ISerializable, System::Xml::Serialization::IXmlSerializable
[System.Serializable]
public class DataTable : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable
type DataTable = class
    inherit MarshalByValueComponent
    interface IListSource
    interface ISupportInitializeNotification
    interface ISerializable
    interface IXmlSerializable
    interface ISupportInitialize
Public Class DataTable
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitializeNotification, IXmlSerializable
継承
派生
属性
実装

次の例では、2 つ作成されますDataTableオブジェクトと 1 つDataRelationオブジェクト、および新しいオブジェクトを追加します、DataSetします。The following example creates two DataTable objects and one DataRelation object, and adds the new objects to a DataSet. テーブルが表示されます、DataGridViewコントロール。The tables are then displayed in a DataGridView control.

// Put the next line into the Declarations section.
private System.Data.DataSet dataSet;

private void MakeDataTables()
{
    // Run all of the functions. 
    MakeParentTable();
    MakeChildTable();
    MakeDataRelation();
    BindToDataGrid();
}

private void MakeParentTable()
{
    // Create a new DataTable.
    System.Data.DataTable table = new DataTable("ParentTable");
    // Declare variables for DataColumn and DataRow objects.
    DataColumn column;
    DataRow row;

    // Create new DataColumn, set DataType, 
    // ColumnName and add to DataTable.    
    column = new DataColumn();
    column.DataType = System.Type.GetType("System.Int32");
    column.ColumnName = "id";
    column.ReadOnly = true;
    column.Unique = true;
    // Add the Column to the DataColumnCollection.
    table.Columns.Add(column);

    // Create second column.
    column = new DataColumn();
    column.DataType = System.Type.GetType("System.String");
    column.ColumnName = "ParentItem";
    column.AutoIncrement = false;
    column.Caption = "ParentItem";
    column.ReadOnly = false;
    column.Unique = false;
    // Add the column to the table.
    table.Columns.Add(column);

    // Make the ID column the primary key column.
    DataColumn[] PrimaryKeyColumns = new DataColumn[1];
    PrimaryKeyColumns[0] = table.Columns["id"];
    table.PrimaryKey = PrimaryKeyColumns;

    // Instantiate the DataSet variable.
    dataSet = new DataSet();
    // Add the new DataTable to the DataSet.
    dataSet.Tables.Add(table);

    // Create three new DataRow objects and add 
    // them to the DataTable
    for (int i = 0; i<= 2; i++)
    {
        row = table.NewRow();
        row["id"] = i;
        row["ParentItem"] = "ParentItem " + i;
        table.Rows.Add(row);
    }
}

private void MakeChildTable()
{
    // Create a new DataTable.
    DataTable table = new DataTable("childTable");
    DataColumn column;
    DataRow row;

    // Create first column and add to the DataTable.
    column = new DataColumn();
    column.DataType= System.Type.GetType("System.Int32");
    column.ColumnName = "ChildID";
    column.AutoIncrement = true;
    column.Caption = "ID";
    column.ReadOnly = true;
    column.Unique = true;

    // Add the column to the DataColumnCollection.
    table.Columns.Add(column);

    // Create second column.
    column = new DataColumn();
    column.DataType= System.Type.GetType("System.String");
    column.ColumnName = "ChildItem";
    column.AutoIncrement = false;
    column.Caption = "ChildItem";
    column.ReadOnly = false;
    column.Unique = false;
    table.Columns.Add(column);

    // Create third column.
    column = new DataColumn();
    column.DataType= System.Type.GetType("System.Int32");
    column.ColumnName = "ParentID";
    column.AutoIncrement = false;
    column.Caption = "ParentID";
    column.ReadOnly = false;
    column.Unique = false;
    table.Columns.Add(column);

    dataSet.Tables.Add(table);

    // Create three sets of DataRow objects, 
    // five rows each, and add to DataTable.
    for(int i = 0; i <= 4; i ++)
    {
        row = table.NewRow();
        row["childID"] = i;
        row["ChildItem"] = "Item " + i;
        row["ParentID"] = 0 ;
        table.Rows.Add(row);
    }
    for(int i = 0; i <= 4; i ++)
    {
        row = table.NewRow();
        row["childID"] = i + 5;
        row["ChildItem"] = "Item " + i;
        row["ParentID"] = 1 ;
        table.Rows.Add(row);
    }
    for(int i = 0; i <= 4; i ++)
    {
        row = table.NewRow();
        row["childID"] = i + 10;
        row["ChildItem"] = "Item " + i;
        row["ParentID"] = 2 ;
        table.Rows.Add(row);
    }
}

private void MakeDataRelation()
{
    // DataRelation requires two DataColumn 
    // (parent and child) and a name.
    DataColumn parentColumn = 
        dataSet.Tables["ParentTable"].Columns["id"];
    DataColumn childColumn = 
        dataSet.Tables["ChildTable"].Columns["ParentID"];
    DataRelation relation = new 
        DataRelation("parent2Child", parentColumn, childColumn);
    dataSet.Tables["ChildTable"].ParentRelations.Add(relation);
}

private void BindToDataGrid()
{
    // Instruct the DataGrid to bind to the DataSet, with the 
    // ParentTable as the topmost DataTable.
    dataGrid1.SetDataBinding(dataSet,"ParentTable");
}
' Put the next line into the Declarations section.
private dataSet As DataSet 
 
Private Sub MakeDataTables()
    ' Run all of the functions. 
    MakeParentTable()
    MakeChildTable()
    MakeDataRelation()
    BindToDataGrid()
End Sub
 
Private Sub MakeParentTable()
    ' Create a new DataTable.
    Dim table As DataTable = new DataTable("ParentTable")

    ' Declare variables for DataColumn and DataRow objects.
    Dim column As DataColumn 
    Dim row As DataRow 
 
    ' Create new DataColumn, set DataType, ColumnName 
    ' and add to DataTable.    
    column = New DataColumn()
    column.DataType = System.Type.GetType("System.Int32")
    column.ColumnName = "id"
    column.ReadOnly = True
    column.Unique = True

    ' Add the Column to the DataColumnCollection.
    table.Columns.Add(column)
 
    ' Create second column.
    column = New DataColumn()
    column.DataType = System.Type.GetType("System.String")
    column.ColumnName = "ParentItem"
    column.AutoIncrement = False
    column.Caption = "ParentItem"
    column.ReadOnly = False
    column.Unique = False

    ' Add the column to the table.
    table.Columns.Add(column)
 
    ' Make the ID column the primary key column.
    Dim PrimaryKeyColumns(0) As DataColumn
    PrimaryKeyColumns(0)= table.Columns("id")
    table.PrimaryKey = PrimaryKeyColumns
 
    ' Instantiate the DataSet variable.
    dataSet = New DataSet()

    ' Add the new DataTable to the DataSet.
    dataSet.Tables.Add(table)
 
    ' Create three new DataRow objects and add 
    ' them to the DataTable
    Dim i As Integer
    For i = 0 to 2
       row = table.NewRow()
       row("id") = i
       row("ParentItem") = "ParentItem " + i.ToString()
       table.Rows.Add(row)
    Next i
End Sub
 
Private Sub MakeChildTable()
    ' Create a new DataTable.
    Dim table As DataTable = New DataTable("childTable")
    Dim column As DataColumn 
    Dim row As DataRow 
 
    ' Create first column and add to the DataTable.
    column = New DataColumn()
    column.DataType= System.Type.GetType("System.Int32")
    column.ColumnName = "ChildID"
    column.AutoIncrement = True
    column.Caption = "ID"
    column.ReadOnly = True
    column.Unique = True

    ' Add the column to the DataColumnCollection.
    table.Columns.Add(column)
 
    ' Create second column.
    column = New DataColumn()
    column.DataType= System.Type.GetType("System.String")
    column.ColumnName = "ChildItem"
    column.AutoIncrement = False
    column.Caption = "ChildItem"
    column.ReadOnly = False
    column.Unique = False
    table.Columns.Add(column)
 
    ' Create third column.
    column = New DataColumn()
    column.DataType= System.Type.GetType("System.Int32")
    column.ColumnName = "ParentID"
    column.AutoIncrement = False
    column.Caption = "ParentID"
    column.ReadOnly = False
    column.Unique = False
    table.Columns.Add(column)
 
    dataSet.Tables.Add(table)

    ' Create three sets of DataRow objects, five rows each, 
    ' and add to DataTable.
    Dim i As Integer
    For i = 0 to 4
       row = table.NewRow()
       row("childID") = i
       row("ChildItem") = "Item " + i.ToString()
       row("ParentID") = 0 
       table.Rows.Add(row)
    Next i
    For i = 0 to 4
       row = table.NewRow()
       row("childID") = i + 5
       row("ChildItem") = "Item " + i.ToString()
       row("ParentID") = 1 
       table.Rows.Add(row)
    Next i
    For i = 0 to 4
       row = table.NewRow()
       row("childID") = i + 10
       row("ChildItem") = "Item " + i.ToString()
       row("ParentID") = 2 
       table.Rows.Add(row)
    Next i
End Sub
 
Private Sub MakeDataRelation()
    ' DataRelation requires two DataColumn 
    ' (parent and child) and a name.
    Dim parentColumn As DataColumn = _
        dataSet.Tables("ParentTable").Columns("id")
    Dim childColumn As DataColumn = _
        dataSet.Tables("ChildTable").Columns("ParentID")
    Dim relation As DataRelation = new _
        DataRelation("parent2Child", parentColumn, childColumn)
    dataSet.Tables("ChildTable").ParentRelations.Add(relation)
End Sub
 
Private Sub BindToDataGrid()
    ' Instruct the DataGrid to bind to the DataSet, with the 
    ' ParentTable as the topmost DataTable.
    DataGrid1.SetDataBinding(dataSet,"ParentTable")
End Sub
 

このサンプルでは、特定のスキーマ定義を含む DataTable を手動で作成する方法を示します。This sample demonstrates how to create a DataTable manually with specific schema definitions:

  • 複数のデータ テーブルを作成し、最初の列を定義します。Create multiple DataTables and define the initial columns.

  • テーブルの制約を作成します。Create the table constraints.

  • 値を挿入し、テーブルを表示します。Insert the values and display the tables.

  • 式列を作成し、テーブルを表示します。Create the expression columns and display the tables.

このコード サンプルの C# および Visual Basic プロジェクトで確認できます開発者コード サンプルします。C# and Visual Basic projects with this code sample can be found on Developer Code Samples.

using System;
using System.Data;

class Program {
   static void Main(string[] args) {
      // Create two tables and add them into the DataSet
      DataTable orderTable = CreateOrderTable();
      DataTable orderDetailTable = CreateOrderDetailTable();
      DataSet salesSet = new DataSet();
      salesSet.Tables.Add(orderTable);
      salesSet.Tables.Add(orderDetailTable);

      // Set the relations between the tables and create the related constraint.
      salesSet.Relations.Add("OrderOrderDetail", orderTable.Columns["OrderId"], orderDetailTable.Columns["OrderId"], true);

      Console.WriteLine("After creating the foreign key constriant, you will see the following error if inserting order detail with the wrong OrderId: ");
      try {
         DataRow errorRow = orderDetailTable.NewRow();
         errorRow[0] = 1;
         errorRow[1] = "O0007";
         orderDetailTable.Rows.Add(errorRow);
      } catch (Exception e) {
         Console.WriteLine(e.Message);
      }
      Console.WriteLine();

      // Insert the rows into the table
      InsertOrders(orderTable);
      InsertOrderDetails(orderDetailTable);

      Console.WriteLine("The initial Order table.");
      ShowTable(orderTable);

      Console.WriteLine("The OrderDetail table.");
      ShowTable(orderDetailTable);

      // Use the Aggregate-Sum on the child table column to get the result.
      DataColumn colSub = new DataColumn("SubTotal", typeof(Decimal), "Sum(Child.LineTotal)");
      orderTable.Columns.Add(colSub);

      // Compute the tax by referencing the SubTotal expression column.
      DataColumn colTax = new DataColumn("Tax", typeof(Decimal), "SubTotal*0.1");
      orderTable.Columns.Add(colTax);

      // If the OrderId is 'Total', compute the due on all orders; or compute the due on this order.
      DataColumn colTotal = new DataColumn("TotalDue", typeof(Decimal), "IIF(OrderId='Total',Sum(SubTotal)+Sum(Tax),SubTotal+Tax)");
      orderTable.Columns.Add(colTotal);

      DataRow row = orderTable.NewRow();
      row["OrderId"] = "Total";
      orderTable.Rows.Add(row);

      Console.WriteLine("The Order table with the expression columns.");
      ShowTable(orderTable);

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

   private static DataTable CreateOrderTable() {
      DataTable orderTable = new DataTable("Order");

      // Define one column.
      DataColumn colId = new DataColumn("OrderId", typeof(String));
      orderTable.Columns.Add(colId);

      DataColumn colDate = new DataColumn("OrderDate", typeof(DateTime));
      orderTable.Columns.Add(colDate);

      // Set the OrderId column as the primary key.
      orderTable.PrimaryKey = new DataColumn[] { colId };

      return orderTable;
   }

   private static DataTable CreateOrderDetailTable() {
      DataTable orderDetailTable = new DataTable("OrderDetail");

      // Define all the columns once.
      DataColumn[] cols ={
                                  new DataColumn("OrderDetailId",typeof(Int32)),
                                  new DataColumn("OrderId",typeof(String)),
                                  new DataColumn("Product",typeof(String)),
                                  new DataColumn("UnitPrice",typeof(Decimal)),
                                  new DataColumn("OrderQty",typeof(Int32)),
                                  new DataColumn("LineTotal",typeof(Decimal),"UnitPrice*OrderQty")
                              };

      orderDetailTable.Columns.AddRange(cols);
      orderDetailTable.PrimaryKey = new DataColumn[] { orderDetailTable.Columns["OrderDetailId"] };
     return orderDetailTable;
   }

   private static void InsertOrders(DataTable orderTable) {
      // Add one row once.
      DataRow row1 = orderTable.NewRow();
      row1["OrderId"] = "O0001";
      row1["OrderDate"] = new DateTime(2013, 3, 1);
      orderTable.Rows.Add(row1);

      DataRow row2 = orderTable.NewRow();
      row2["OrderId"] = "O0002";
      row2["OrderDate"] = new DateTime(2013, 3, 12);
      orderTable.Rows.Add(row2);

      DataRow row3 = orderTable.NewRow();
      row3["OrderId"] = "O0003";
      row3["OrderDate"] = new DateTime(2013, 3, 20);
      orderTable.Rows.Add(row3);
   }

   private static void InsertOrderDetails(DataTable orderDetailTable) {
      // Use an Object array to insert all the rows .
      // Values in the array are matched sequentially to the columns, based on the order in which they appear in the table.
      Object[] rows = {
                                 new Object[]{1,"O0001","Mountain Bike",1419.5,36},
                                 new Object[]{2,"O0001","Road Bike",1233.6,16},
                                 new Object[]{3,"O0001","Touring Bike",1653.3,32},
                                 new Object[]{4,"O0002","Mountain Bike",1419.5,24},
                                 new Object[]{5,"O0002","Road Bike",1233.6,12},
                                 new Object[]{6,"O0003","Mountain Bike",1419.5,48},
                                 new Object[]{7,"O0003","Touring Bike",1653.3,8},
                             };

      foreach (Object[] row in rows) {
         orderDetailTable.Rows.Add(row);
      }
   }

   private static void ShowTable(DataTable table) {
      foreach (DataColumn col in table.Columns) {
         Console.Write("{0,-14}", col.ColumnName);
      }
      Console.WriteLine();

      foreach (DataRow row in table.Rows) {
         foreach (DataColumn col in table.Columns) {
            if (col.DataType.Equals(typeof(DateTime)))
               Console.Write("{0,-14:d}", row[col]);
            else if (col.DataType.Equals(typeof(Decimal)))
               Console.Write("{0,-14:C}", row[col]);
            else
               Console.Write("{0,-14}", row[col]);           
         }
         Console.WriteLine();
      }
      Console.WriteLine();
   }
}
Imports System.Data

Class Program
   Public Shared Sub Main(args As String())
      ' Create two tables and add them into the DataSet
      Dim orderTable As DataTable = CreateOrderTable()
      Dim orderDetailTable As DataTable = CreateOrderDetailTable()
      Dim salesSet As New DataSet()
      salesSet.Tables.Add(orderTable)
      salesSet.Tables.Add(orderDetailTable)

      ' Set the relations between the tables and create the related constraint.
      salesSet.Relations.Add("OrderOrderDetail", orderTable.Columns("OrderId"), orderDetailTable.Columns("OrderId"), True)

      Console.WriteLine("After creating the foreign key constriant, you will see the following error if inserting order detail with the wrong OrderId: ")
      Try
         Dim errorRow As DataRow = orderDetailTable.NewRow()
         errorRow(0) = 1
         errorRow(1) = "O0007"
         orderDetailTable.Rows.Add(errorRow)
      Catch e As Exception
         Console.WriteLine(e.Message)
      End Try
      Console.WriteLine()

      ' Insert the rows into the table
      InsertOrders(orderTable)
      InsertOrderDetails(orderDetailTable)

      Console.WriteLine("The initial Order table.")
      ShowTable(orderTable)

      Console.WriteLine("The OrderDetail table.")
      ShowTable(orderDetailTable)

      ' Use the Aggregate-Sum on the child table column to get the result.
      Dim colSub As New DataColumn("SubTotal", GetType([Decimal]), "Sum(Child.LineTotal)")
      orderTable.Columns.Add(colSub)

      ' Compute the tax by referencing the SubTotal expression column.
      Dim colTax As New DataColumn("Tax", GetType([Decimal]), "SubTotal*0.1")
      orderTable.Columns.Add(colTax)

      ' If the OrderId is 'Total', compute the due on all orders; or compute the due on this order.
      Dim colTotal As New DataColumn("TotalDue", GetType([Decimal]), "IIF(OrderId='Total',Sum(SubTotal)+Sum(Tax),SubTotal+Tax)")
      orderTable.Columns.Add(colTotal)

      Dim row As DataRow = orderTable.NewRow()
      row("OrderId") = "Total"
      orderTable.Rows.Add(row)

      Console.WriteLine("The Order table with the expression columns.")
      ShowTable(orderTable)

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

   Private Shared Function CreateOrderTable() As DataTable
      Dim orderTable As New DataTable("Order")

      ' Define one column.
      Dim colId As New DataColumn("OrderId", GetType([String]))
      orderTable.Columns.Add(colId)

      Dim colDate As New DataColumn("OrderDate", GetType(DateTime))
      orderTable.Columns.Add(colDate)

      ' Set the OrderId column as the primary key.
      orderTable.PrimaryKey = New DataColumn() {colId}

      Return orderTable
   End Function

   Private Shared Function CreateOrderDetailTable() As DataTable
      Dim orderDetailTable As New DataTable("OrderDetail")

      ' Define all the columns once.
      Dim cols As DataColumn() = {New DataColumn("OrderDetailId", GetType(Int32)), New DataColumn("OrderId", GetType([String])), New DataColumn("Product", GetType([String])), New DataColumn("UnitPrice", GetType([Decimal])), New DataColumn("OrderQty", GetType(Int32)), New DataColumn("LineTotal", GetType([Decimal]), "UnitPrice*OrderQty")}

      orderDetailTable.Columns.AddRange(cols)
      orderDetailTable.PrimaryKey = New DataColumn() {orderDetailTable.Columns("OrderDetailId")}
      Return orderDetailTable
   End Function

   Private Shared Sub InsertOrders(orderTable As DataTable)
      ' Add one row once.
      Dim row1 As DataRow = orderTable.NewRow()
      row1("OrderId") = "O0001"
      row1("OrderDate") = New DateTime(2013, 3, 1)
      orderTable.Rows.Add(row1)

      Dim row2 As DataRow = orderTable.NewRow()
      row2("OrderId") = "O0002"
      row2("OrderDate") = New DateTime(2013, 3, 12)
      orderTable.Rows.Add(row2)

      Dim row3 As DataRow = orderTable.NewRow()
      row3("OrderId") = "O0003"
      row3("OrderDate") = New DateTime(2013, 3, 20)
      orderTable.Rows.Add(row3)
   End Sub

   Private Shared Sub InsertOrderDetails(orderDetailTable As DataTable)
      ' Use an Object array to insert all the rows .
      ' Values in the array are matched sequentially to the columns, based on the order in which they appear in the table.
      Dim rows As [Object]() = {New [Object]() {1, "O0001", "Mountain Bike", 1419.5, 36}, New [Object]() {2, "O0001", "Road Bike", 1233.6, 16}, New [Object]() {3, "O0001", "Touring Bike", 1653.3, 32}, New [Object]() {4, "O0002", "Mountain Bike", 1419.5, 24}, New [Object]() {5, "O0002", "Road Bike", 1233.6, 12}, New [Object]() {6, "O0003", "Mountain Bike", 1419.5, 48}, _
         New [Object]() {7, "O0003", "Touring Bike", 1653.3, 8}}

      For Each row As [Object]() In rows
         orderDetailTable.Rows.Add(row)
      Next
   End Sub

   Private Shared Sub ShowTable(table As DataTable)
      For Each col As DataColumn In table.Columns
         Console.Write("{0,-14}", col.ColumnName)
      Next
      Console.WriteLine()

      For Each row As DataRow In table.Rows
         For Each col As DataColumn In table.Columns
            If col.DataType.Equals(GetType(DateTime)) Then
               Console.Write("{0,-14:d}", row(col))
            ElseIf col.DataType.Equals(GetType([Decimal])) Then
               Console.Write("{0,-14:C}", row(col))
            Else
               Console.Write("{0,-14}", row(col))
            End If
         Next
         Console.WriteLine()
      Next
      Console.WriteLine()
   End Sub
End Class

注釈

DataTableは ADO.NET ライブラリ内のサーバーの全体のオブジェクトです。The DataTable is a central object in the ADO.NET library. 他のオブジェクトを使用して、DataTable含める、 DataSetDataViewします。Other objects that use the DataTable include the DataSet and the DataView.

アクセスするときにDataTableオブジェクトでは、条件付きで大文字小文字が区別されることに注意してください。When accessing DataTable objects, note that they are conditionally case sensitive. たとえば、1 つDataTable"mydatatable"という名前し"Mydatatable"という 2 つは、1 つのテーブルの検索に使用される文字列は大文字と小文字を区別見なされます。For example, if one DataTable is named "mydatatable" and another is named "Mydatatable", a string used to search for one of the tables is regarded as case sensitive. ただし、"mydatatable"が存在し、"Mydatatable"は、検索文字列は、大文字と小文字を区別しない見なされます。However, if "mydatatable" exists and "Mydatatable" does not, the search string is regarded as case insensitive. A DataSet 2 つ含めることができますDataTableオブジェクトが同じTableNameプロパティの値が異なるNamespaceプロパティの値。A DataSet can contain two DataTable objects that have the same TableName property value but different Namespace property values. 操作の詳細についてはDataTable、オブジェクトを参照してくださいDataTable の作成です。For more information about working with DataTable objects, see Creating a DataTable.

作成する場合、DataTableプログラムでは、最初に定義してそのスキーマを追加してDataColumnオブジェクトをDataColumnCollection(を使用してアクセス、Columnsプロパティ)。If you are creating a DataTable programmatically, you must first define its schema by adding DataColumn objects to the DataColumnCollection (accessed through the Columns property). 追加の詳細についてはDataColumn、オブジェクトを参照してくださいDataTable に列の追加します。For more information about adding DataColumn objects, see Adding Columns to a DataTable.

行を追加する、 DataTable、最初に使用する必要があります、NewRowを返す新しいメソッドをDataRowオブジェクト。To add rows to a DataTable, you must first use the NewRow method to return a new DataRow object. NewRowメソッドのスキーマとの行を返します、DataTableによって、テーブルの定義は、DataColumnCollectionします。The NewRow method returns a row with the schema of the DataTable, as it is defined by the table's DataColumnCollection. 最大数の行をDataTableできますストアが 16,777, 216 します。The maximum number of rows that a DataTable can store is 16,777,216. 詳細については、次を参照してください。 DataTable にデータを追加するします。For more information, see Adding Data to a DataTable.

DataTableのコレクションを格納もConstraintオブジェクト データの整合性を確保するために使用できます。The DataTable also contains a collection of Constraint objects that can be used to ensure the integrity of the data. 詳細については、次を参照してください。 DataTable の制約します。For more information, see DataTable Constraints.

たくさんDataTableテーブルに変更があったときを判断するために使用できるイベント。There are many DataTable events that can be used to determine when changes are made to a table. これには、RowChangedRowChangingRowDeleting、および RowDeleted が含まれます。These include RowChanged, RowChanging, RowDeleting, and RowDeleted. 使用できるイベントの詳細については、DataTableを参照してくださいDataTable イベントの処理します。For more information about the events that can be used with a DataTable, see Handling DataTable Events.

インスタンスDataTable作成されると、いくつか読み取り/書き込みのプロパティは、初期値に設定されます。When an instance of DataTable is created, some of the read/write properties are set to initial values. これらの値の一覧は、次を参照してください。、DataTable.DataTableコンス トラクターのトピックです。For a list of these values, see the DataTable.DataTable constructor topic.

注意

DataSetDataTableオブジェクトから継承MarshalByValueComponent、およびサポート、 ISerializable .NET Framework リモート処理用のインターフェイス。The DataSet and DataTable objects inherit from MarshalByValueComponent, and support the ISerializable interface for .NET Framework remoting. これらは、.NET Framework リモート処理用に使用できる唯一の ADO.NET オブジェクトです。These are the only ADO.NET objects that you can use for .NET Framework remoting.

コンストラクター

DataTable() DataTable() DataTable() DataTable()

引数を指定せずに、DataTable クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataTable class with no arguments.

DataTable(SerializationInfo, StreamingContext) DataTable(SerializationInfo, StreamingContext) DataTable(SerializationInfo, StreamingContext) DataTable(SerializationInfo, StreamingContext)

DataTableSerializationInfo を使用して、StreamingContext クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataTable class with the SerializationInfo and the StreamingContext.

DataTable(String) DataTable(String) DataTable(String) DataTable(String)

指定したテーブル名を使用して DataTable クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataTable class with the specified table name.

DataTable(String, String) DataTable(String, String) DataTable(String, String) DataTable(String, String)

指定したテーブル名と名前空間を使用して、DataTable クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataTable class using the specified table name and namespace.

フィールド

fInitInProgress fInitInProgress fInitInProgress fInitInProgress

初期化処理中かどうかをチェックします。Checks whether initialization is in progress. 初期化は実行時に発生します。The initialization occurs at run time.

プロパティ

CaseSensitive CaseSensitive CaseSensitive CaseSensitive

テーブル内の文字列比較で大文字と小文字を区別するかどうかを示します。Indicates whether string comparisons within the table are case-sensitive.

ChildRelations ChildRelations ChildRelations ChildRelations

この DataTable の子リレーションシップのコレクションを取得します。Gets the collection of child relations for this DataTable.

Columns Columns Columns Columns

このテーブルに属する列のコレクションを取得します。Gets the collection of columns that belong to this table.

Constraints Constraints Constraints Constraints

このテーブルに保持されている制約のコレクションを取得します。Gets the collection of constraints maintained by this table.

Container Container Container Container

コンポーネントを格納するコンテナーを取得します。Gets the container for the component.

(Inherited from MarshalByValueComponent)
DataSet DataSet DataSet DataSet

このテーブルが属する DataSet を取得します。Gets the DataSet to which this table belongs.

DefaultView DefaultView DefaultView DefaultView

フィルター処理されたビューまたはカーソル位置を含むことがある、テーブルのカスタマイズされたビューを取得します。Gets a customized view of the table that may include a filtered view, or a cursor position.

DesignMode DesignMode DesignMode DesignMode

コンポーネントが現在デザイン モードかどうかを示す値を取得します。Gets a value indicating whether the component is currently in design mode.

(Inherited from MarshalByValueComponent)
DisplayExpression DisplayExpression DisplayExpression DisplayExpression

ユーザー インターフェイスにこのテーブルを表示するために使用する値を返す式を取得または設定します。Gets or sets the expression that returns a value used to represent this table in the user interface. DisplayExpression プロパティを使用すると、ユーザー インターフェイスにこのテーブルの名前が表示されます。The DisplayExpression property lets you display the name of this table in a user interface.

Events Events Events Events

コンポーネントに結び付けられているイベント ハンドラーのリストを取得します。Gets the list of event handlers that are attached to this component.

(Inherited from MarshalByValueComponent)
ExtendedProperties ExtendedProperties ExtendedProperties ExtendedProperties

カスタマイズされたユーザー情報のコレクションを取得します。Gets the collection of customized user information.

HasErrors HasErrors HasErrors HasErrors

テーブルが属する DataSet のいずれかのテーブルのいずれかの行にエラーがあるかどうかを示す値を取得します。Gets a value indicating whether there are errors in any of the rows in any of the tables of the DataSet to which the table belongs.

IsInitialized IsInitialized IsInitialized IsInitialized

DataTable が初期化されているかどうかを示す値を取得します。Gets a value that indicates whether the DataTable is initialized.

Locale Locale Locale Locale

テーブル内の文字列の比較に使用するロケール情報を取得または設定します。Gets or sets the locale information used to compare strings within the table.

MinimumCapacity MinimumCapacity MinimumCapacity MinimumCapacity

このテーブルの初期開始サイズを取得または設定します。Gets or sets the initial starting size for this table.

Namespace Namespace Namespace Namespace

DataTable に格納されているデータの XML 表現の名前空間を取得または設定します。Gets or sets the namespace for the XML representation of the data stored in the DataTable.

ParentRelations ParentRelations ParentRelations ParentRelations

この DataTable の親リレーションシップのコレクションを取得します。Gets the collection of parent relations for this DataTable.

Prefix Prefix Prefix Prefix

DataTable に格納されているデータの XML 表現の名前空間を取得または設定します。Gets or sets the namespace for the XML representation of the data stored in the DataTable.

PrimaryKey PrimaryKey PrimaryKey PrimaryKey

このデータ テーブルの主キーとして機能する列の配列を取得または設定します。Gets or sets an array of columns that function as primary keys for the data table.

RemotingFormat RemotingFormat RemotingFormat RemotingFormat

シリアル化形式を取得または設定します。Gets or sets the serialization format.

Rows Rows Rows Rows

このテーブルに属する行のコレクションを取得します。Gets the collection of rows that belong to this table.

Site Site Site Site

ISiteDataTable を取得または設定します。Gets or sets an ISite for the DataTable.

TableName TableName TableName TableName

DataTable の名前を取得または設定します。Gets or sets the name of the DataTable.

メソッド

AcceptChanges() AcceptChanges() AcceptChanges() AcceptChanges()

前回 AcceptChanges() を呼び出した以降にこのテーブルに対して行われたすべての変更をコミットします。Commits all the changes made to this table since the last time AcceptChanges() was called.

BeginInit() BeginInit() BeginInit() BeginInit()

フォームまたは別のコンポーネントで使用する DataTable の初期化を開始します。Begins the initialization of a DataTable that is used on a form or used by another component. 初期化は実行時に発生します。The initialization occurs at run time.

BeginLoadData() BeginLoadData() BeginLoadData() BeginLoadData()

データを読み込む間、通知、インデックスの維持、および制約をオフにします。Turns off notifications, index maintenance, and constraints while loading data.

Clear() Clear() Clear() Clear()

DataTable からすべてのデータを消去します。Clears the DataTable of all data.

Clone() Clone() Clone() Clone()

すべての DataTable スキーマおよび制約を含め DataTable の構造体のクローンを作成します。Clones the structure of the DataTable, including all DataTable schemas and constraints.

Compute(String, String) Compute(String, String) Compute(String, String) Compute(String, String)

フィルター基準を満たしている現在の行で指定した式を計算します。Computes the given expression on the current rows that pass the filter criteria.

Copy() Copy() Copy() Copy()

この DataTable の構造体だけでなくデータもコピーします。Copies both the structure and data for this DataTable.

CreateDataReader() CreateDataReader() CreateDataReader() CreateDataReader()

この DataTableReader 内のデータに対応する DataTable を返します。Returns a DataTableReader corresponding to the data within this DataTable.

CreateInstance() CreateInstance() CreateInstance() CreateInstance()

DataTable の新しいインスタンスを作成します。Creates a new instance of DataTable.

Dispose() Dispose() Dispose() Dispose()

MarshalByValueComponent によって使用されているすべてのリソースを解放します。Releases all resources used by the MarshalByValueComponent.

(Inherited from MarshalByValueComponent)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

MarshalByValueComponent によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(Inherited from MarshalByValueComponent)
EndInit() EndInit() EndInit() EndInit()

フォームまたは別のコンポーネントで使用する DataTable の初期化を終了します。Ends the initialization of a DataTable that is used on a form or used by another component. 初期化は実行時に発生します。The initialization occurs at run time.

EndLoadData() EndLoadData() EndLoadData() EndLoadData()

データを読み込んだ後、通知、インデックスの維持、および制約をオンにします。Turns on notifications, index maintenance, and constraints after loading data.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetChanges() GetChanges() GetChanges() GetChanges()

前回 DataTable を読み取るか、AcceptChanges() を呼び出した以降にこのデータセットに対して行われたすべての変更が格納されているこのデータセットのコピーを取得します。Gets a copy of the DataTable that contains all changes made to it since it was loaded or AcceptChanges() was last called.

GetChanges(DataRowState) GetChanges(DataRowState) GetChanges(DataRowState) GetChanges(DataRowState)

前回 DataTable を読み取るか、AcceptChanges() を呼び出した以降にこのデータセットに対して行われたすべての変更が格納されているこのデータセットのコピーを、DataRowState によってフィルター処理した後で取得します。Gets a copy of the DataTable containing all changes made to it since it was last loaded, or since AcceptChanges() was called, filtered by DataRowState.

GetDataTableSchema(XmlSchemaSet) GetDataTableSchema(XmlSchemaSet) GetDataTableSchema(XmlSchemaSet) GetDataTableSchema(XmlSchemaSet)

このメソッドは、Web サービスの XmlSchemaSet を記述する Web サービス記述言語 (WSDL) を含む DataTable インスタンスを返します。This method returns an XmlSchemaSet instance containing the Web Services Description Language (WSDL) that describes the DataTable for Web Services.

GetErrors() GetErrors() GetErrors() GetErrors()

エラーが含まれる DataRow オブジェクトの配列を取得します。Gets an array of DataRow objects that contain errors.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

シリアル化情報オブジェクトを、DataTable のシリアル化に必要なデータで事前設定します。Populates a serialization information object with the data needed to serialize the DataTable.

GetRowType() GetRowType() GetRowType() GetRowType()

行の種類を取得します。Gets the row type.

GetSchema() GetSchema() GetSchema() GetSchema()

このメンバーの説明については、GetSchema() のトピックを参照してください。For a description of this member, see GetSchema().

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

IServiceProvider を実装しているオブジェクトを取得します。Gets the implementer of the IServiceProvider.

(Inherited from MarshalByValueComponent)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
ImportRow(DataRow) ImportRow(DataRow) ImportRow(DataRow) ImportRow(DataRow)

プロパティ設定、元の値、および現在の値を保持し、DataRowDataTable にコピーします。Copies a DataRow into a DataTable, preserving any property settings, as well as original and current values.

Load(IDataReader) Load(IDataReader) Load(IDataReader) Load(IDataReader)

指定された DataTable を使用し、IDataReader にデータ ソースからの値を設定します。Fills a DataTable with values from a data source using the supplied IDataReader. DataTable が既に行を含んでいる場合、データ ソースからの受信データは既存の行にマージされます。If the DataTable already contains rows, the incoming data from the data source is merged with the existing rows.

Load(IDataReader, LoadOption) Load(IDataReader, LoadOption) Load(IDataReader, LoadOption) Load(IDataReader, LoadOption)

指定された DataTable を使用し、IDataReader にデータ ソースからの値を設定します。Fills a DataTable with values from a data source using the supplied IDataReader. DataTable が既に行を含んでいる場合、loadOption パラメーターの値に従って、データ ソースからの受信データは既存の行にマージされます。If the DataTable already contains rows, the incoming data from the data source is merged with the existing rows according to the value of the loadOption parameter.

Load(IDataReader, LoadOption, FillErrorEventHandler) Load(IDataReader, LoadOption, FillErrorEventHandler) Load(IDataReader, LoadOption, FillErrorEventHandler) Load(IDataReader, LoadOption, FillErrorEventHandler)

エラー処理デリゲートを使用し、指定された DataTable を使用して、IDataReader にデータ ソースからの値を設定します。Fills a DataTable with values from a data source using the supplied IDataReader using an error-handling delegate.

LoadDataRow(Object[], Boolean) LoadDataRow(Object[], Boolean) LoadDataRow(Object[], Boolean) LoadDataRow(Object[], Boolean)

特定の行を検索し、更新します。Finds and updates a specific row. 一致する行が見つからない場合は、指定した値を使用して新しい行が作成されます。If no matching row is found, a new row is created using the given values.

LoadDataRow(Object[], LoadOption) LoadDataRow(Object[], LoadOption) LoadDataRow(Object[], LoadOption) LoadDataRow(Object[], LoadOption)

特定の行を検索し、更新します。Finds and updates a specific row. 一致する行が見つからない場合は、指定した値を使用して新しい行が作成されます。If no matching row is found, a new row is created using the given values.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
Merge(DataTable) Merge(DataTable) Merge(DataTable) Merge(DataTable)

指定した DataTable を現在の DataTable とマージします。Merge the specified DataTable with the current DataTable.

Merge(DataTable, Boolean) Merge(DataTable, Boolean) Merge(DataTable, Boolean) Merge(DataTable, Boolean)

指定した DataTable を現在の DataTable とマージし、現在の DataTable の変更を保持するかどうかを指定します。Merge the specified DataTable with the current DataTable, indicating whether to preserve changes in the current DataTable.

Merge(DataTable, Boolean, MissingSchemaAction) Merge(DataTable, Boolean, MissingSchemaAction) Merge(DataTable, Boolean, MissingSchemaAction) Merge(DataTable, Boolean, MissingSchemaAction)

指定した DataTable を現在の DataTable とマージして、現在の DataTable の変更を保持するかどうかを指定し、さらに欠けているスキーマの処理方法を指定します。Merge the specified DataTable with the current DataTable, indicating whether to preserve changes and how to handle missing schema in the current DataTable.

NewRow() NewRow() NewRow() NewRow()

テーブルと同じスキーマで新しい DataRow を作成します。Creates a new DataRow with the same schema as the table.

NewRowArray(Int32) NewRowArray(Int32) NewRowArray(Int32) NewRowArray(Int32)

DataRow の配列を返します。Returns an array of DataRow.

NewRowFromBuilder(DataRowBuilder) NewRowFromBuilder(DataRowBuilder) NewRowFromBuilder(DataRowBuilder) NewRowFromBuilder(DataRowBuilder)

既存の行から新しい行を作成します。Creates a new row from an existing row.

OnColumnChanged(DataColumnChangeEventArgs) OnColumnChanged(DataColumnChangeEventArgs) OnColumnChanged(DataColumnChangeEventArgs) OnColumnChanged(DataColumnChangeEventArgs)

ColumnChanged イベントを発生させます。Raises the ColumnChanged event.

OnColumnChanging(DataColumnChangeEventArgs) OnColumnChanging(DataColumnChangeEventArgs) OnColumnChanging(DataColumnChangeEventArgs) OnColumnChanging(DataColumnChangeEventArgs)

ColumnChanging イベントを発生させます。Raises the ColumnChanging event.

OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs)

PropertyChanged イベントを発生させます。Raises the PropertyChanged event.

OnRemoveColumn(DataColumn) OnRemoveColumn(DataColumn) OnRemoveColumn(DataColumn) OnRemoveColumn(DataColumn)

DataTable が削除されることを DataColumn に通知します。Notifies the DataTable that a DataColumn is being removed.

OnRowChanged(DataRowChangeEventArgs) OnRowChanged(DataRowChangeEventArgs) OnRowChanged(DataRowChangeEventArgs) OnRowChanged(DataRowChangeEventArgs)

RowChanged イベントを発生させます。Raises the RowChanged event.

OnRowChanging(DataRowChangeEventArgs) OnRowChanging(DataRowChangeEventArgs) OnRowChanging(DataRowChangeEventArgs) OnRowChanging(DataRowChangeEventArgs)

RowChanging イベントを発生させます。Raises the RowChanging event.

OnRowDeleted(DataRowChangeEventArgs) OnRowDeleted(DataRowChangeEventArgs) OnRowDeleted(DataRowChangeEventArgs) OnRowDeleted(DataRowChangeEventArgs)

RowDeleted イベントを発生させます。Raises the RowDeleted event.

OnRowDeleting(DataRowChangeEventArgs) OnRowDeleting(DataRowChangeEventArgs) OnRowDeleting(DataRowChangeEventArgs) OnRowDeleting(DataRowChangeEventArgs)

RowDeleting イベントを発生させます。Raises the RowDeleting event.

OnTableCleared(DataTableClearEventArgs) OnTableCleared(DataTableClearEventArgs) OnTableCleared(DataTableClearEventArgs) OnTableCleared(DataTableClearEventArgs)

TableCleared イベントを発生させます。Raises the TableCleared event.

OnTableClearing(DataTableClearEventArgs) OnTableClearing(DataTableClearEventArgs) OnTableClearing(DataTableClearEventArgs) OnTableClearing(DataTableClearEventArgs)

TableClearing イベントを発生させます。Raises the TableClearing event.

OnTableNewRow(DataTableNewRowEventArgs) OnTableNewRow(DataTableNewRowEventArgs) OnTableNewRow(DataTableNewRowEventArgs) OnTableNewRow(DataTableNewRowEventArgs)

TableNewRow イベントを発生させます。Raises the TableNewRow event.

ReadXml(Stream) ReadXml(Stream) ReadXml(Stream) ReadXml(Stream)

指定した DataTable を使用して、XML スキーマとデータを Stream に読み込みます。Reads XML schema and data into the DataTable using the specified Stream.

ReadXml(String) ReadXml(String) ReadXml(String) ReadXml(String)

指定したファイルから、XML スキーマとデータを DataTable に読み込みます。Reads XML schema and data into the DataTable from the specified file.

ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader)

指定した DataTable を使用して、XML スキーマとデータを TextReader に読み込みます。Reads XML schema and data into the DataTable using the specified TextReader.

ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader)

指定した DataTable を使用して、XML スキーマとデータを XmlReader に読み込みます。Reads XML Schema and Data into the DataTable using the specified XmlReader.

ReadXmlSchema(Stream) ReadXmlSchema(Stream) ReadXmlSchema(Stream) ReadXmlSchema(Stream)

指定したストリームを使用して、XML スキーマを DataTable に読み込みます。Reads an XML schema into the DataTable using the specified stream.

ReadXmlSchema(String) ReadXmlSchema(String) ReadXmlSchema(String) ReadXmlSchema(String)

指定したファイルから DataTable に XML スキーマを読み込みます。Reads an XML schema into the DataTable from the specified file.

ReadXmlSchema(TextReader) ReadXmlSchema(TextReader) ReadXmlSchema(TextReader) ReadXmlSchema(TextReader)

指定した DataTable を使用して、XML スキーマを TextReader に読み込みます。Reads an XML schema into the DataTable using the specified TextReader.

ReadXmlSchema(XmlReader) ReadXmlSchema(XmlReader) ReadXmlSchema(XmlReader) ReadXmlSchema(XmlReader)

指定した DataTable を使用して、XML スキーマを XmlReader に読み込みます。Reads an XML schema into the DataTable using the specified XmlReader.

ReadXmlSerializable(XmlReader) ReadXmlSerializable(XmlReader) ReadXmlSerializable(XmlReader) ReadXmlSerializable(XmlReader)

XML ストリームから読み取ります。Reads from an XML stream.

RejectChanges() RejectChanges() RejectChanges() RejectChanges()

このテーブルを読み込むか、前回 AcceptChanges() を呼び出した以降にこのテーブルに対して行われたすべての変更をロールバックします。Rolls back all changes that have been made to the table since it was loaded, or the last time AcceptChanges() was called.

Reset() Reset() Reset() Reset()

DataTable を元の状態にリセットします。Resets the DataTable to its original state. テーブルのすべてのデータ、インデックス、リレーションシップ、および列の削除をリセットします。Reset removes all data, indexes, relations, and columns of the table. DataSet に DataTable が含まれている場合は、テーブルをリセットした後も、テーブルは DataSet の一部です。If a DataSet includes a DataTable, the table will still be part of the DataSet after the table is reset.

Select() Select() Select() Select()

すべての DataRow オブジェクトの配列を取得します。Gets an array of all DataRow objects.

Select(String) Select(String) Select(String) Select(String)

フィルター基準と一致するすべての DataRow オブジェクトの配列を取得します。Gets an array of all DataRow objects that match the filter criteria.

Select(String, String) Select(String, String) Select(String, String) Select(String, String)

フィルター基準と一致するすべての DataRow オブジェクトの配列を、指定した並べ替え順で取得します。Gets an array of all DataRow objects that match the filter criteria, in the specified sort order.

Select(String, String, DataViewRowState) Select(String, String, DataViewRowState) Select(String, String, DataViewRowState) Select(String, String, DataViewRowState)

フィルター基準と一致するすべての DataRow オブジェクトの配列を、指定した状態と一致する並べ替え順に取得します。Gets an array of all DataRow objects that match the filter in the order of the sort that match the specified state.

ToString() ToString() ToString() ToString()

TableNameDisplayExpression が連結された文字列として存在する場合は、これらを取得します。Gets the TableName and DisplayExpression, if there is one as a concatenated string.

WriteXml(Stream) WriteXml(Stream) WriteXml(Stream) WriteXml(Stream)

DataTable の現在の内容を指定された Stream を使用して XML として書き込みます。Writes the current contents of the DataTable as XML using the specified Stream.

WriteXml(Stream, Boolean) WriteXml(Stream, Boolean) WriteXml(Stream, Boolean) WriteXml(Stream, Boolean)

DataTable の現在の内容を指定された Stream を使用して XML として書き込みます。Writes the current contents of the DataTable as XML using the specified Stream. テーブルのデータとその子孫をすべて保存するには、writeHierarchy パラメーターを true に設定します。To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode)

指定した DataTable を使用して、XmlWriteMode の現在のデータを、指定したファイルに書き込みます。オプションでスキーマを書き込むこともできます。Writes the current data, and optionally the schema, for the DataTable to the specified file using the specified XmlWriteMode. スキーマを書き込むには、mode パラメーターの値を WriteSchema に設定します。To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(Stream, XmlWriteMode, Boolean) WriteXml(Stream, XmlWriteMode, Boolean) WriteXml(Stream, XmlWriteMode, Boolean) WriteXml(Stream, XmlWriteMode, Boolean)

指定した DataTable を使用して、XmlWriteMode の現在のデータを、指定したファイルに書き込みます。オプションでスキーマを書き込むこともできます。Writes the current data, and optionally the schema, for the DataTable to the specified file using the specified XmlWriteMode. スキーマを書き込むには、mode パラメーターの値を WriteSchema に設定します。To write the schema, set the value for the mode parameter to WriteSchema. テーブルのデータとその子孫をすべて保存するには、writeHierarchy パラメーターを true に設定します。To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(String) WriteXml(String) WriteXml(String) WriteXml(String)

指定したファイルを使用して DataTable の現在の内容を XML で書き込みます。Writes the current contents of the DataTable as XML using the specified file.

WriteXml(String, Boolean) WriteXml(String, Boolean) WriteXml(String, Boolean) WriteXml(String, Boolean)

指定したファイルを使用して DataTable の現在の内容を XML で書き込みます。Writes the current contents of the DataTable as XML using the specified file. テーブルのデータとその子孫をすべて保存するには、writeHierarchy パラメーターを true に設定します。To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode)

指定したファイルと DataTable を使用して、XmlWriteMode の現在のデータを書き込みます。オプションでスキーマを書き込むこともできます。Writes the current data, and optionally the schema, for the DataTable using the specified file and XmlWriteMode. スキーマを書き込むには、mode パラメーターの値を WriteSchema に設定します。To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(String, XmlWriteMode, Boolean) WriteXml(String, XmlWriteMode, Boolean) WriteXml(String, XmlWriteMode, Boolean) WriteXml(String, XmlWriteMode, Boolean)

指定したファイルと DataTable を使用して、XmlWriteMode の現在のデータを書き込みます。オプションでスキーマを書き込むこともできます。Writes the current data, and optionally the schema, for the DataTable using the specified file and XmlWriteMode. スキーマを書き込むには、mode パラメーターの値を WriteSchema に設定します。To write the schema, set the value for the mode parameter to WriteSchema. テーブルのデータとその子孫をすべて保存するには、writeHierarchy パラメーターを true に設定します。To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter)

DataTable の現在の内容を指定された TextWriter を使用して XML として書き込みます。Writes the current contents of the DataTable as XML using the specified TextWriter.

WriteXml(TextWriter, Boolean) WriteXml(TextWriter, Boolean) WriteXml(TextWriter, Boolean) WriteXml(TextWriter, Boolean)

DataTable の現在の内容を指定された TextWriter を使用して XML として書き込みます。Writes the current contents of the DataTable as XML using the specified TextWriter. テーブルのデータとその子孫をすべて保存するには、writeHierarchy パラメーターを true に設定します。To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode)

指定した DataTableTextWriter を使用して、XmlWriteMode の現在のデータを書き込みます。オプションでスキーマを書き込むこともできます。Writes the current data, and optionally the schema, for the DataTable using the specified TextWriter and XmlWriteMode. スキーマを書き込むには、mode パラメーターの値を WriteSchema に設定します。To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(TextWriter, XmlWriteMode, Boolean) WriteXml(TextWriter, XmlWriteMode, Boolean) WriteXml(TextWriter, XmlWriteMode, Boolean) WriteXml(TextWriter, XmlWriteMode, Boolean)

指定した DataTableTextWriter を使用して、XmlWriteMode の現在のデータを書き込みます。オプションでスキーマを書き込むこともできます。Writes the current data, and optionally the schema, for the DataTable using the specified TextWriter and XmlWriteMode. スキーマを書き込むには、mode パラメーターの値を WriteSchema に設定します。To write the schema, set the value for the mode parameter to WriteSchema. テーブルのデータとその子孫をすべて保存するには、writeHierarchy パラメーターを true に設定します。To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter)

DataTable の現在の内容を指定された XmlWriter を使用して XML として書き込みます。Writes the current contents of the DataTable as XML using the specified XmlWriter.

WriteXml(XmlWriter, Boolean) WriteXml(XmlWriter, Boolean) WriteXml(XmlWriter, Boolean) WriteXml(XmlWriter, Boolean)

DataTable の現在の内容を指定された XmlWriter を使用して XML として書き込みます。Writes the current contents of the DataTable as XML using the specified XmlWriter.

WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode)

指定した DataTableXmlWriter を使用して、XmlWriteMode の現在のデータを書き込みます。オプションでスキーマを書き込むこともできます。Writes the current data, and optionally the schema, for the DataTable using the specified XmlWriter and XmlWriteMode. スキーマを書き込むには、mode パラメーターの値を WriteSchema に設定します。To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(XmlWriter, XmlWriteMode, Boolean) WriteXml(XmlWriter, XmlWriteMode, Boolean) WriteXml(XmlWriter, XmlWriteMode, Boolean) WriteXml(XmlWriter, XmlWriteMode, Boolean)

指定した DataTableXmlWriter を使用して、XmlWriteMode の現在のデータを書き込みます。オプションでスキーマを書き込むこともできます。Writes the current data, and optionally the schema, for the DataTable using the specified XmlWriter and XmlWriteMode. スキーマを書き込むには、mode パラメーターの値を WriteSchema に設定します。To write the schema, set the value for the mode parameter to WriteSchema. テーブルのデータとその子孫をすべて保存するには、writeHierarchy パラメーターを true に設定します。To save the data for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXmlSchema(Stream) WriteXmlSchema(Stream) WriteXmlSchema(Stream) WriteXmlSchema(Stream)

DataTable の現在のデータ構造体を指定されたストリームに XML スキーマとして書き込みます。Writes the current data structure of the DataTable as an XML schema to the specified stream.

WriteXmlSchema(Stream, Boolean) WriteXmlSchema(Stream, Boolean) WriteXmlSchema(Stream, Boolean) WriteXmlSchema(Stream, Boolean)

DataTable の現在のデータ構造体を指定されたストリームに XML スキーマとして書き込みます。Writes the current data structure of the DataTable as an XML schema to the specified stream. テーブルのスキーマとその子孫をすべて保存するには、writeHierarchy パラメーターを true に設定します。To save the schema for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXmlSchema(String) WriteXmlSchema(String) WriteXmlSchema(String) WriteXmlSchema(String)

DataTable の現在のデータ構造体を指定されたファイルに XML スキーマとして書き込みます。Writes the current data structure of the DataTable as an XML schema to the specified file.

WriteXmlSchema(String, Boolean) WriteXmlSchema(String, Boolean) WriteXmlSchema(String, Boolean) WriteXmlSchema(String, Boolean)

DataTable の現在のデータ構造体を指定されたファイルに XML スキーマとして書き込みます。Writes the current data structure of the DataTable as an XML schema to the specified file. テーブルのスキーマとその子孫をすべて保存するには、writeHierarchy パラメーターを true に設定します。To save the schema for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXmlSchema(TextWriter) WriteXmlSchema(TextWriter) WriteXmlSchema(TextWriter) WriteXmlSchema(TextWriter)

指定した DataTable を使用して、TextWriter の現在のデータ構造体を XML スキーマとして書き込みます。Writes the current data structure of the DataTable as an XML schema using the specified TextWriter.

WriteXmlSchema(TextWriter, Boolean) WriteXmlSchema(TextWriter, Boolean) WriteXmlSchema(TextWriter, Boolean) WriteXmlSchema(TextWriter, Boolean)

指定した DataTable を使用して、TextWriter の現在のデータ構造体を XML スキーマとして書き込みます。Writes the current data structure of the DataTable as an XML schema using the specified TextWriter. テーブルのスキーマとその子孫をすべて保存するには、writeHierarchy パラメーターを true に設定します。To save the schema for the table and all its descendants, set the writeHierarchy parameter to true.

WriteXmlSchema(XmlWriter) WriteXmlSchema(XmlWriter) WriteXmlSchema(XmlWriter) WriteXmlSchema(XmlWriter)

指定した DataTable を使用して、XmlWriter の現在のデータ構造体を XML スキーマとして書き込みます。Writes the current data structure of the DataTable as an XML schema using the specified XmlWriter.

WriteXmlSchema(XmlWriter, Boolean) WriteXmlSchema(XmlWriter, Boolean) WriteXmlSchema(XmlWriter, Boolean) WriteXmlSchema(XmlWriter, Boolean)

指定した DataTable を使用して、XmlWriter の現在のデータ構造体を XML スキーマとして書き込みます。Writes the current data structure of the DataTable as an XML schema using the specified XmlWriter. テーブルのスキーマとその子孫をすべて保存するには、writeHierarchy パラメーターを true に設定します。To save the schema for the table and all its descendants, set the writeHierarchy parameter to true.

イベント

ColumnChanged ColumnChanged ColumnChanged ColumnChanged

DataColumn 内の指定した DataRow の値が変更された後に発生します。Occurs after a value has been changed for the specified DataColumn in a DataRow.

ColumnChanging ColumnChanging ColumnChanging ColumnChanging

DataColumn 内の指定した DataRow の値が変更されているときに発生します。Occurs when a value is being changed for the specified DataColumn in a DataRow.

Disposed Disposed Disposed Disposed

コンポーネントの Disposed イベントを待機するイベント ハンドラーを追加します。Adds an event handler to listen to the Disposed event on the component.

(Inherited from MarshalByValueComponent)
Initialized Initialized Initialized Initialized

DataTable が初期化された後に発生します。Occurs after the DataTable is initialized.

RowChanged RowChanged RowChanged RowChanged

DataRow が正常に変更された後に発生します。Occurs after a DataRow has been changed successfully.

RowChanging RowChanging RowChanging RowChanging

DataRow が変更されているときに発生します。Occurs when a DataRow is changing.

RowDeleted RowDeleted RowDeleted RowDeleted

テーブル内の行が削除された後に発生します。Occurs after a row in the table has been deleted.

RowDeleting RowDeleting RowDeleting RowDeleting

テーブル内の行が削除される直前に発生します。Occurs before a row in the table is about to be deleted.

TableCleared TableCleared TableCleared TableCleared

DataTable が消去された後に発生します。Occurs after a DataTable is cleared.

TableClearing TableClearing TableClearing TableClearing

DataTable が削除されたときに発生します。Occurs when a DataTable is cleared.

TableNewRow TableNewRow TableNewRow TableNewRow

新しい DataRow が挿入されると発生します。Occurs when a new DataRow is inserted.

明示的なインターフェイスの実装

IListSource.ContainsListCollection IListSource.ContainsListCollection IListSource.ContainsListCollection IListSource.ContainsListCollection

このメンバーの説明については、ContainsListCollection のトピックを参照してください。For a description of this member, see ContainsListCollection.

IListSource.GetList() IListSource.GetList() IListSource.GetList() IListSource.GetList()

このメンバーの説明については、GetList() のトピックを参照してください。For a description of this member, see GetList().

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

シリアル化情報オブジェクトを、DataTable のシリアル化に必要なデータで事前設定します。Populates a serialization information object with the data needed to serialize the DataTable.

IXmlSerializable.GetSchema() IXmlSerializable.GetSchema() IXmlSerializable.GetSchema() IXmlSerializable.GetSchema()

このメンバーの説明については、GetSchema() のトピックを参照してください。For a description of this member, see GetSchema().

IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader)

このメンバーの説明については、ReadXml(XmlReader) のトピックを参照してください。For a description of this member, see ReadXml(XmlReader).

IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter)

このメンバーの説明については、WriteXml(XmlWriter) のトピックを参照してください。For a description of this member, see WriteXml(XmlWriter).

Extension Methods

AsDataView(DataTable) AsDataView(DataTable) AsDataView(DataTable) AsDataView(DataTable)

LINQ 対応の DataView オブジェクトを作成して返します。Creates and returns a LINQ-enabled DataView object.

AsEnumerable(DataTable) AsEnumerable(DataTable) AsEnumerable(DataTable) AsEnumerable(DataTable)

IEnumerable<T> オブジェクトを返します。ここで、ジェネリック パラメーター TDataRow です。Returns an IEnumerable<T> object, where the generic parameter T is DataRow. このオブジェクトは、LINQLINQ 式またはメソッド クエリで使用できます。This object can be used in a LINQLINQ expression or method query.

適用対象

スレッド セーフ

この型は、マルチ スレッドの読み取り操作も安全です。This type is safe for multithreaded read operations. 書き込み操作を同期する必要があります。You must synchronize any write operations.

こちらもご覧ください