DataTable Osztály

Definíció

Egy memóriabeli adattáblát jelöl.

public ref class DataTable : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, System::ComponentModel::ISupportInitialize, System::ComponentModel::ISupportInitializeNotification, System::Runtime::Serialization::ISerializable, System::Xml::Serialization::IXmlSerializable
public ref class DataTable
public ref class DataTable : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, System::ComponentModel::ISupportInitialize, System::Runtime::Serialization::ISerializable
public ref class DataTable : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, System::ComponentModel::ISupportInitializeNotification, System::Runtime::Serialization::ISerializable, System::Xml::Serialization::IXmlSerializable
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicConstructors | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataTable : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitialize, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable
public class DataTable : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitialize, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable
public class DataTable
[System.Serializable]
public class DataTable : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitialize, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class DataTable : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable
public class DataTable : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicConstructors | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataTable = class
    inherit MarshalByValueComponent
    interface IListSource
    interface ISupportInitialize
    interface ISupportInitializeNotification
    interface ISerializable
    interface IXmlSerializable
type DataTable = class
    inherit MarshalByValueComponent
    interface IListSource
    interface ISupportInitialize
    interface ISupportInitializeNotification
    interface ISerializable
    interface IXmlSerializable
type DataTable = class
[<System.Serializable>]
type DataTable = class
    inherit MarshalByValueComponent
    interface IListSource
    interface ISupportInitialize
    interface ISerializable
[<System.Serializable>]
type DataTable = class
    inherit MarshalByValueComponent
    interface IListSource
    interface ISupportInitializeNotification
    interface ISupportInitialize
    interface ISerializable
    interface IXmlSerializable
Public Class DataTable
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitialize, ISupportInitializeNotification, IXmlSerializable
Public Class DataTable
Public Class DataTable
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitialize
Public Class DataTable
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitializeNotification, IXmlSerializable
Öröklődés
Öröklődés
DataTable
Származtatott
Attribútumok
Megvalósítás

Példák

Ez a minta bemutatja, hogyan hozhat létre manuálisan dataTable-t adott sémadefiníciókkal:

  • Hozzon létre több DataTables-t, és határozza meg a kezdeti oszlopokat.
  • Hozza létre a táblakorlátozásokat.
  • Szúrja be az értékeket, és jelenítse meg a táblákat.
  • Hozza létre a kifejezésoszlopokat, és jelenítse meg a táblákat.
using System;
using System.Data;

class Program
{
    static void Main()
    {
        // Create two tables and add them into the DataSet.
        DataTable orderTable = CreateOrderTable();
        DataTable orderDetailTable = CreateOrderDetailTable();
        DataSet salesSet = new();
        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 constraint, " +
            "you'll see the following error if you insert " +
            "an order detail with the wrong OrderId:\n");
        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("SubTotal", typeof(decimal), "Sum(Child.LineTotal)");
        orderTable.Columns.Add(colSub);

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

        // If the OrderId is 'Total', compute the amount due on all orders; otherwise, compute the amount due on this order.
        DataColumn colTotal = new(
            "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("Order");

        // Define the columns one at a time.
        DataColumn colId = new("OrderId", typeof(string));
        orderTable.Columns.Add(colId);

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

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

        return orderTable;
    }

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

        // Define all the columns at once.
        DataColumn[] cols =
        [
            new DataColumn("OrderDetailId", typeof(int)),
            new DataColumn("OrderId", typeof(string)),
            new DataColumn("Product", typeof(string)),
            new DataColumn("UnitPrice", typeof(decimal)),
            new DataColumn("OrderQty", typeof(int)),
            new DataColumn("LineTotal", typeof(decimal), "UnitPrice*OrderQty")
        ];

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

    private static void InsertOrders(DataTable orderTable)
    {
        // Add one row at a time.
        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 =
        [
            [1, "O0001", "Mountain Bike", 1419.5, 36],
            [2, "O0001", "Road Bike", 1233.6, 16],
            [3, "O0001", "Touring Bike", 1653.3, 32],
            [4, "O0002", "Mountain Bike", 1419.5, 24],
            [5, "O0002", "Road Bike", 1233.6, 12],
            [6, "O0003", "Mountain Bike", 1419.5, 48],
            [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();
    }
}
' 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 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 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

Megjegyzések

Az DataTable osztály egy központi objektum a ADO.NET könyvtárban. Egyéb, a használt DataTable objektumok közé tartozik az DataSet és a DataView.

DataTable az objektumnevek feltételesen megkülönböztetik a kis- és nagybetűket. Ha például az egyik DataTable neve "mydatatable", a másik neve "Mydatatable", akkor az egyik tábla keresésére használt sztring megkülönbözteti a kis- és nagybetűk értékét. Ha azonban a "mydatatable" létezik, és a "Mydatatable" nem, a keresési sztring érzéketlennek minősül. Az A DataSet két DataTable objektumot tartalmazhat, amelyek azonos TableName tulajdonságértékekkel rendelkeznek, de eltérő Namespace tulajdonságértékekkel. Az objektumok használatával DataTable kapcsolatos további információkért lásd: DataTable létrehozása.

Ha programozott módon szeretne létrehozni egy DataTable-t, először meg kell határoznia annak sémáját úgy, hogy DataColumn objektumokat ad hozzá a DataColumnCollection-hoz (amely a Columns tulajdonságon keresztül érhető el). Az objektumok hozzáadásáról DataColumn további információt az Oszlopok hozzáadása adattáblához című témakörben talál.

Sorok hozzáadásához DataTableelőször a NewRow metódust kell használnia egy új DataRow objektum visszaadásához. A NewRow metódus egy sort ad vissza a DataTable tábla sémájával, ahogyan azt a tábla DataColumnCollection szerint meghatározták. A tárolható sorok DataTable maximális száma 16 777 216. További információ: Adatok hozzáadása a DataTable-hoz.

Emellett DataTable olyan objektumgyűjteményt Constraint is tartalmaz, amely az adatok integritásának biztosítására használható. További információ: DataTable Constraints.

Számos DataTable esemény használható annak meghatározására, hogy mikor történik egy tábla módosítása. Ezek közé tartoznak a következők: RowChanged, RowChangingés RowDeletingRowDeleted. Az adattáblával DataTablehasználható eseményekről további információt az Adattáblás események kezelése című témakörben talál.

Egy példány DataTable létrehozásakor az olvasási/írási tulajdonságok egy része kezdeti értékre van állítva. Ezeknek az értékeknek a listáját a konstruktorban DataTable találja.

Note

A DataSet és DataTable objektumok öröklik a MarshalByValueComponent-t, és támogatják a ISerializable felületet a .NET távoli kommunikációhoz. Ezek az egyetlen ADO.NET objektumok, amelyeket a .NET távoli eléréshez használhat.

Biztonsági megfontolások

A DataSet és a DataTable biztonságáról további információt a Biztonsági útmutatóban talál.

Konstruktorok

Name Description
DataTable()

Inicializálja az DataTable osztály új példányát argumentumok nélkül.

DataTable(SerializationInfo, StreamingContext)
Elavult.

Inicializálja az DataTable osztály új példányát szerializált adatokkal.

DataTable(String, String)

Inicializálja az DataTable osztály új példányát a megadott táblanév és névtér használatával.

DataTable(String)

Inicializálja az osztály új példányát DataTable a megadott táblanévvel.

Mezők

Name Description
fInitInProgress

Ellenőrzi, hogy az inicializálás folyamatban van-e. Az inicializálás futásidőben történik.

Tulajdonságok

Name Description
CaseSensitive

Azt jelzi, hogy a tábla sztring-összehasonlításai megkülönböztetik-e a kis- és nagybetűket.

ChildRelations

Lekéri ehhez a gyermekkapcsolatok gyűjteményét DataTable.

Columns

Lekéri a táblázathoz tartozó oszlopok gyűjteményét.

Constraints

Lekéri a tábla által fenntartott korlátozások gyűjteményét.

Container

Lekéri az összetevő tárolót.

(Öröklődés forrása MarshalByValueComponent)
DataSet

Lekéri, DataSet hogy melyik táblához tartozik.

DefaultView

Lekéri a táblázat testreszabott nézetét, amely szűrt nézetet vagy kurzorpozíciót is tartalmazhat.

DesignMode

Egy értéket kap, amely jelzi, hogy az összetevő jelenleg tervezési módban van-e.

(Öröklődés forrása MarshalByValueComponent)
DisplayExpression

Lekéri vagy beállítja azt a kifejezést, amely a tábla megjelenítéséhez használt értéket adja vissza a felhasználói felületen. A DisplayExpression tulajdonság lehetővé teszi a tábla nevének megjelenítését egy felhasználói felületen.

Events

Lekéri az összetevőhöz csatolt eseménykezelők listáját.

(Öröklődés forrása MarshalByValueComponent)
ExtendedProperties

Lekéri a testre szabott felhasználói adatok gyűjteményét.

HasErrors

Egy értéket kap, amely jelzi, hogy a tábla egyik táblájának DataSet soraiban vannak-e hibák.

IsInitialized

Olyan értéket kap, amely jelzi, hogy az DataTable inicializálva van-e.

Locale

Lekéri vagy beállítja a táblázat sztringjeinek összehasonlításához használt területi adatokat.

MinimumCapacity

Lekéri vagy beállítja a tábla kezdeti kezdő méretét.

Namespace

Lekéri vagy beállítja a névteret a fájlban tárolt adatok XML-reprezentációja DataTableszámára.

ParentRelations

Lekéri ehhez a szülőkapcsolatok gyűjteményét DataTable.

Prefix

Lekéri vagy beállítja a névteret a fájlban tárolt adatok XML-reprezentációja DataTableszámára.

PrimaryKey

Lekéri vagy beállít egy oszloptömböt, amely az adattábla elsődleges kulcsaként működik.

RemotingFormat

Lekéri vagy beállítja a szerializálási formátumot.

Rows

Lekéri a táblázathoz tartozó sorok gyűjteményét.

Site

Lekéri vagy beállítja ISite a DataTable.

TableName

Lekéri vagy beállítja a DataTablenevét.

Metódusok

Name Description
AcceptChanges()

Véglegesíti a tábla legutóbbi AcceptChanges() hívása óta végrehajtott összes módosítást.

BeginInit()

Megkezdi egy űrlapon használt vagy egy másik összetevő által használt elem inicializálását DataTable . Az inicializálás futásidőben történik.

BeginLoadData()

Az adatok betöltésekor kikapcsolja az értesítéseket, az indexkarbantartást és a korlátozásokat.

Clear()

Törli az DataTable összes adatot.

Clone()

Klónozza a struktúra szerkezetét, beleértve az DataTableösszes DataTable sémát és kényszert.

Compute(String, String)

Kiszámítja a megadott kifejezést az aktuális sorokon, amelyek megfelelnek a szűrési feltételeknek.

Copy()

Ennek a struktúrának és az adatoknak a másolása DataTable.

CreateDataReader()

A megadott adatoknak megfelelő értéket ad DataTableReader vissza.DataTable

CreateInstance()

Létrehoz egy új példányt a DataTable.

Dispose()

Felszabadítja a .-hez használt összes erőforrást MarshalByValueComponent.

(Öröklődés forrása MarshalByValueComponent)
Dispose(Boolean)

Felszabadítja a felügyelt erőforrások által MarshalByValueComponent használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat.

(Öröklődés forrása MarshalByValueComponent)
EndInit()

Egy űrlapon használt vagy egy másik összetevő által használt inicializálásának DataTable befejezése. Az inicializálás futásidőben történik.

EndLoadData()

Az adatok betöltése után bekapcsolja az értesítéseket, az indexkarbantartást és a korlátozásokat.

Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
GetChanges()

Lekéri annak a másolatnak a másolatát, amely tartalmazza a DataTable betöltött vagy AcceptChanges() legutóbbi hívás óta végrehajtott összes módosítást.

GetChanges(DataRowState)

Lekéri annak a másolatát, amely tartalmazza a DataTable legutóbbi betöltés óta végrehajtott összes módosítást, vagy mivel AcceptChanges() a rendszer meghívta, szűrte.DataRowState

GetDataTableSchema(XmlSchemaSet)

Ez a metódus egy olyan példányt XmlSchemaSet ad vissza, amely a Web Services leírási nyelvét (WSDL) tartalmazza, amely leírja a DataTable Web Services használatát.

GetErrors()

Lekéri a DataRow hibákat tartalmazó objektumtömböt.

GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetObjectData(SerializationInfo, StreamingContext)
Elavult.

Szerializálási információs objektumot tölt fel a szerializáláshoz DataTableszükséges adatokkal.

GetRowType()

Lekéri a sor típusát.

GetSchema()

Ennek a tagnak a leírását lásd GetSchema(): .

GetService(Type)

Lekéri a végrehajtó a IServiceProvider.

(Öröklődés forrása MarshalByValueComponent)
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
ImportRow(DataRow)

Átmásolja a DataRowDataTabletulajdonságbeállításokat, valamint az eredeti és az aktuális értékeket.

Load(IDataReader, LoadOption, FillErrorEventHandler)

Egy adatforrás értékeit DataTable tölti ki a megadott IDataReader hibakezelési meghatalmazott használatával.

Load(IDataReader, LoadOption)

Egy adatforrás értékeit DataTable tölti ki a megadott IDataReaderparanccsal. Ha a DataTable már tartalmaz sorokat, az adatforrásból érkező bejövő adatok a paraméter értékének megfelelően egyesülnek a loadOption meglévő sorokkal.

Load(IDataReader)

Egy adatforrás értékeit DataTable tölti ki a megadott IDataReaderparanccsal. Ha a DataTable már tartalmaz sorokat, az adatforrásból érkező bejövő adatok egyesülnek a meglévő sorokkal.

LoadDataRow(Object[], Boolean)

Megkeres és frissít egy adott sort. Ha nem található egyező sor, a rendszer új sort hoz létre a megadott értékekkel.

LoadDataRow(Object[], LoadOption)

Megkeres és frissít egy adott sort. Ha nem található egyező sor, a rendszer új sort hoz létre a megadott értékekkel.

MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
Merge(DataTable, Boolean, MissingSchemaAction)

Egyesítse a megadottt DataTable az aktuálissal DataTable, jelezve, hogy meg szeretné-e őrizni a módosításokat, és hogyan kezelheti a hiányzó sémát az aktuálisban DataTable.

Merge(DataTable, Boolean)

Egyesítse a megadottt DataTable az aktuálissal DataTable, jelezve, hogy meg szeretné-e őrizni az aktuális DataTablemódosításokat.

Merge(DataTable)

A megadott DataTable és az aktuális DataTableegyesítés.

NewRow()

Létrehoz egy újat DataRow ugyanazzal a sémával, mint a táblázat.

NewRowArray(Int32)

Egy tömböt DataRowad vissza.

NewRowFromBuilder(DataRowBuilder)

Új sort hoz létre egy meglévő sorból.

OnColumnChanged(DataColumnChangeEventArgs)

Az eseményt emeli ColumnChanged ki.

OnColumnChanging(DataColumnChangeEventArgs)

Az eseményt emeli ColumnChanging ki.

OnPropertyChanging(PropertyChangedEventArgs)

Az eseményt emeli PropertyChanged ki.

OnRemoveColumn(DataColumn)

Értesítést küld arról, hogy egy DataTableDataColumn el lett távolítva.

OnRowChanged(DataRowChangeEventArgs)

Az eseményt emeli RowChanged ki.

OnRowChanging(DataRowChangeEventArgs)

Az eseményt emeli RowChanging ki.

OnRowDeleted(DataRowChangeEventArgs)

Az eseményt emeli RowDeleted ki.

OnRowDeleting(DataRowChangeEventArgs)

Az eseményt emeli RowDeleting ki.

OnTableCleared(DataTableClearEventArgs)

Az eseményt emeli TableCleared ki.

OnTableClearing(DataTableClearEventArgs)

Az eseményt emeli TableClearing ki.

OnTableNewRow(DataTableNewRowEventArgs)

Az eseményt emeli TableNewRow ki.

ReadXml(Stream)

Beolvassa az XML-sémát és az adatokat a DataTable megadott Stream.

ReadXml(String)

Beolvassa az XML-sémát és az adatokat a DataTable megadott fájlba.

ReadXml(TextReader)

Beolvassa az XML-sémát és az adatokat a DataTable megadott TextReader.

ReadXml(XmlReader)

Beolvassa az XML-sémát és az adatokat a DataTable megadott XmlReaderfájlba.

ReadXmlSchema(Stream)

Beolvassa az XML-sémát a DataTable megadott streambe.

ReadXmlSchema(String)

Beolvassa az XML-sémát a DataTable megadott fájlba.

ReadXmlSchema(TextReader)

Beolvassa az XML-sémát a DataTable megadott TextReaderfájlba.

ReadXmlSchema(XmlReader)

Beolvassa az XML-sémát a DataTable megadott XmlReaderfájlba.

ReadXmlSerializable(XmlReader)

Olvasás XML-adatfolyamból.

RejectChanges()

Visszaállítja az összes módosítást, amely a tábla betöltése óta történt, vagy az utolsó alkalommal AcceptChanges() lett meghívva.

Reset()

Visszaállítja az DataTable eredeti állapotot. Az alaphelyzetbe állítás eltávolítja a tábla összes adatát, indexét, kapcsolatát és oszlopát. Ha egy DataSet tartalmaz egy DataTable-t, a tábla a tábla alaphelyzetbe állítása után is az Adathalmaz része lesz.

Select()

Lekéri az összes DataRow objektum tömbét.

Select(String, String, DataViewRowState)

Lekéri a szűrőnek megfelelő összes DataRow objektum tömbét a megadott állapotnak megfelelő rendezési sorrendben.

Select(String, String)

A megadott rendezési sorrendben lekéri az összes DataRow olyan objektum tömbét, amely megfelel a szűrési feltételeknek.

Select(String)

Lekéri a szűrőfeltételeknek megfelelő összes DataRow objektum tömbét.

ToString()

Lekéri az TableName és DisplayExpression, ha van egy összefűzött sztring.

ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)
WriteXml(Stream, Boolean)

A megadott DataTableparanccsal XML-ként írja be az Stream aktuális tartalmat. A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

WriteXml(Stream, XmlWriteMode, Boolean)

A megadott fájlhoz tartozó aktuális adatokat és opcionálisan a sémát írja a megadott fájlba DataTable a megadott XmlWriteModehasználatával. A séma írásához állítsa a paraméter értékét a mode következőre WriteSchema: . A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

WriteXml(Stream, XmlWriteMode)

A megadott fájlhoz tartozó aktuális adatokat és opcionálisan a sémát írja a megadott fájlba DataTable a megadott XmlWriteModehasználatával. A séma írásához állítsa a paraméter értékét a mode következőre WriteSchema: .

WriteXml(Stream)

A megadott DataTableparanccsal XML-ként írja be az Stream aktuális tartalmat.

WriteXml(String, Boolean)

A megadott fájl használatával XML-ként írja be az DataTable aktuális tartalmat. A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

WriteXml(String, XmlWriteMode, Boolean)

Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott fájl és XmlWriteMode. A séma írásához állítsa a paraméter értékét a mode következőre WriteSchema: . A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

WriteXml(String, XmlWriteMode)

Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott fájl és XmlWriteMode. A séma írásához állítsa a paraméter értékét a mode következőre WriteSchema: .

WriteXml(String)

A megadott fájl használatával XML-ként írja be az DataTable aktuális tartalmat.

WriteXml(TextWriter, Boolean)

A megadott DataTableparanccsal XML-ként írja be az TextWriter aktuális tartalmat. A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

WriteXml(TextWriter, XmlWriteMode, Boolean)

Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott TextWriter és XmlWriteModea . A séma írásához állítsa a paraméter értékét a mode következőre WriteSchema: . A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

WriteXml(TextWriter, XmlWriteMode)

Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott TextWriter és XmlWriteModea . A séma írásához állítsa a paraméter értékét a mode következőre WriteSchema: .

WriteXml(TextWriter)

A megadott DataTableparanccsal XML-ként írja be az TextWriter aktuális tartalmat.

WriteXml(XmlWriter, Boolean)

A megadott DataTableparanccsal XML-ként írja be az XmlWriter aktuális tartalmat.

WriteXml(XmlWriter, XmlWriteMode, Boolean)

Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott XmlWriter és XmlWriteModea . A séma írásához állítsa a paraméter értékét a mode következőre WriteSchema: . A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

WriteXml(XmlWriter, XmlWriteMode)

Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott XmlWriter és XmlWriteModea . A séma írásához állítsa a paraméter értékét a mode következőre WriteSchema: .

WriteXml(XmlWriter)

A megadott DataTableparanccsal XML-ként írja be az XmlWriter aktuális tartalmat.

WriteXmlSchema(Stream, Boolean)

Az aktuális adatszerkezetet DataTable XML-sémaként írja a megadott streambe. A tábla és az összes leszármazott sémájának mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

WriteXmlSchema(Stream)

Az aktuális adatszerkezetet DataTable XML-sémaként írja a megadott streambe.

WriteXmlSchema(String, Boolean)

Az aktuális adatszerkezetet DataTable XML-sémaként írja a megadott fájlba. A tábla és az összes leszármazott sémájának mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

WriteXmlSchema(String)

Az aktuális adatszerkezetet DataTable XML-sémaként írja a megadott fájlba.

WriteXmlSchema(TextWriter, Boolean)

Az aktuális adatszerkezetet DataTable XML-sémaként írja a megadott TextWriterhasználatával. A tábla és az összes leszármazott sémájának mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

WriteXmlSchema(TextWriter)

Az aktuális adatszerkezetet DataTable XML-sémaként írja a megadott TextWriterhasználatával.

WriteXmlSchema(XmlWriter, Boolean)

Az aktuális adatszerkezetet DataTable XML-sémaként írja a megadott XmlWriterhasználatával. A tábla és az összes leszármazott sémájának mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

WriteXmlSchema(XmlWriter)

Az aktuális adatszerkezetet DataTable XML-sémaként írja a megadott XmlWriterhasználatával.

esemény

Name Description
ColumnChanged

A megadott érték módosítása DataColumn után következik be.DataRow

ColumnChanging

Akkor fordul elő, ha a megadott érték módosul a megadott DataColumn értéken DataRow.

Disposed

Hozzáad egy eseménykezelőt az összetevő eseményének Disposed figyeléséhez.

(Öröklődés forrása MarshalByValueComponent)
Initialized

Az inicializálás után DataTable következik be.

RowChanged

Egy sikeres módosítás után DataRow következik be.

RowChanging

A változókor DataRow következik be.

RowDeleted

A tábla egy sorának törlése után következik be.

RowDeleting

A tábla egy sorának törlése előtt következik be.

TableCleared

A törlés után DataTable következik be.

TableClearing

A törléskor DataTable következik be.

TableNewRow

Új beszúráskor DataRow következik be.

Explicit interfész-implementációk

Name Description
IListSource.ContainsListCollection

Ennek a tagnak a leírását lásd ContainsListCollection: .

IListSource.GetList()

Ennek a tagnak a leírását lásd GetList(): .

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Szerializálási információs objektumot tölt fel a szerializáláshoz DataTableszükséges adatokkal.

IXmlSerializable.GetSchema()

Ennek a tagnak a leírását lásd GetSchema(): .

IXmlSerializable.ReadXml(XmlReader)

Ennek a tagnak a leírását lásd ReadXml(XmlReader): .

IXmlSerializable.WriteXml(XmlWriter)

Ennek a tagnak a leírását lásd WriteXml(XmlWriter): .

Bővítő metódusok

Name Description
AsDataView(DataTable)

LINQ-kompatibilis objektumot hoz létre és ad DataView vissza.

AsEnumerable(DataTable)

Egy IEnumerable<T> objektumot ad vissza, amelyben az általános paraméter T szerepel DataRow. Ez az objektum használható LINQ-kifejezésben vagy metóduslekérdezésben.

CreateAsyncScope(IServiceProvider)

Létrehoz egy újat AsyncServiceScope , amely a hatókörön belüli szolgáltatások feloldására használható.

CreateScope(IServiceProvider)

Létrehoz egy újat IServiceScope , amely a hatókörön belüli szolgáltatások feloldására használható.

GetKeyedService(IServiceProvider, Type, Object)

A szolgáltatás típusának serviceType lekérése a IServiceProvider.

GetKeyedService<T>(IServiceProvider, Object)

A szolgáltatás típusának T lekérése a IServiceProvider.

GetKeyedServices(IServiceProvider, Type, Object)

Kérje le a szolgáltatások serviceType számbavételét a IServiceProvider.

GetKeyedServices<T>(IServiceProvider, Object)

Kérje le a szolgáltatások T számbavételét a IServiceProvider.

GetRequiredKeyedService(IServiceProvider, Type, Object)

A szolgáltatás típusának serviceType lekérése a IServiceProvider.

GetRequiredKeyedService<T>(IServiceProvider, Object)

A szolgáltatás típusának T lekérése a IServiceProvider.

GetRequiredService(IServiceProvider, Type)

A szolgáltatás típusának serviceType lekérése a IServiceProvider.

GetRequiredService<T>(IServiceProvider)

A szolgáltatás típusának T lekérése a IServiceProvider.

GetService<T>(IServiceProvider)

A szolgáltatás típusának T lekérése a IServiceProvider.

GetServices(IServiceProvider, Type)

Kérje le a szolgáltatások serviceType számbavételét a IServiceProvider.

GetServices<T>(IServiceProvider)

Kérje le a szolgáltatások T számbavételét a IServiceProvider.

A következőre érvényes:

Szálbiztonság

Ez a típus biztonságos a többszálas olvasási műveletekhez. Minden írási műveletet szinkronizálnia kell.

Lásd még