DataColumn Osztály

Definíció

Névtér:

System.Data

Szerelvények:

netstandard.dll, System.Data.Common.dll

Forrás:

DataColumn.cs

Egy oszlop sémáját jelöli egy DataTable.

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataColumn : System.ComponentModel.MarshalByValueComponent

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataColumn = class
    inherit MarshalByValueComponent

Public Class DataColumn
Inherits MarshalByValueComponent

Öröklődés

Object

MarshalByValueComponent

DataColumn

Attribútumok

DynamicallyAccessedMembersAttribute

Példák

Az alábbi példa több DataTable objektummal hoz létre egy DataColumn objektumot.

private void MakeTable()
{
    // Create a DataTable.
    DataTable table = new DataTable("Product");

    // Create a DataColumn and set various properties.
    DataColumn column = new DataColumn();
    column.DataType = System.Type.GetType("System.Decimal");
    column.AllowDBNull = false;
    column.Caption = "Price";
    column.ColumnName = "Price";
    column.DefaultValue = 25;

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

    // Add 10 rows and set values.
    DataRow row;
    for(int i = 0; i < 10; i++)
    {
        row = table.NewRow();
        row["Price"] = i + 1;

        // Be sure to add the new row to the
        // DataRowCollection.
        table.Rows.Add(row);
    }
}

Private Sub MakeTable()
    ' Create a DataTable. 
    Dim table As New DataTable("Product")

    ' Create a DataColumn and set various properties. 
    Dim column As New DataColumn()
    column.DataType = System.Type.GetType("System.Decimal") 
    column.AllowDBNull = False 
    column.Caption = "Price"  
    column.ColumnName = "Price" 
    column.DefaultValue = 25 

    ' Add the column to the table. 
    table.Columns.Add(column) 

    ' Add 10 rows and set values. 
    Dim row As DataRow 
    Dim i As Integer  
    For i = 0 to 9 
        row = table.NewRow() 
        row("Price") = i + 1 

        ' Be sure to add the new row to 
        ' the DataRowCollection. 
        table.Rows.Add(row) 
    Next i 
End Sub

Megjegyzések

Ez DataColumn a séma létrehozásának alapvető építőeleme DataTable. A sémát úgy hozhatja létre, hogy hozzáad egy vagy több DataColumn objektumot a DataColumnCollection. További információ: Oszlopok hozzáadása a DataTable-hoz.

Mindegyiknek DataColumn van egy DataType tulajdonsága, amely meghatározza, hogy milyen típusú adatokat DataColumn tartalmaz. Az adattípust például egész számokra, sztringekre vagy decimálisokra korlátozhatja. Mivel a DataTable rendszer általában az eredeti adatforrásba egyesít adatokat, az adatforrásban lévő adattípusokkal kell egyeznie. További információ: Adattípus-leképezések az ADO-ban.NET.

Az olyan tulajdonságok, mint AllowDBNulla , Uniqueés ReadOnly korlátozásokat léptetnek életbe az adatok bevitelére és frissítésére, ezáltal biztosítva az adatintegritást. Az automatikus adatlétrehozás vezérléséhez használhatja a AutoIncrement, AutoIncrementSeedés AutoIncrementStep a tulajdonságokat is. Az oszlopokról AutoIncrement további információt az AutoIncrement-oszlopok létrehozása című témakörben talál. További információ: Elsődleges kulcsok definiálása.

Azt is ellenőrizheti, hogy az értékek DataColumn egyediek-e, ha létrehoz egy UniqueConstraint értéket, és hozzáadja azt ahhozConstraintCollection, DataTable amelyhez tartoznakDataColumn. További információ: DataTable Constraints.

Objektumok közötti DataColumn kapcsolat létrehozásához hozzon létre egy objektumot DataRelation , és adja hozzá egy DataRelationCollection objektumhoz DataSet.

Az objektum tulajdonságával kiszámíthatja Expression az DataColumn oszlop értékeit, vagy összesített oszlopot hozhat létre. További információ: Kifejezésoszlopok létrehozása.

Konstruktorok

Name	Description
DataColumn()	Az osztály új példányát inicializálja DataColumn típussztringként.
DataColumn(String, Type, String, MappingType)	Inicializálja az osztály új példányát a DataColumn megadott név, adattípus, kifejezés és érték használatával, amely meghatározza, hogy az oszlop attribútum-e.
DataColumn(String, Type, String)	Inicializálja az DataColumn osztály új példányát a megadott név, adattípus és kifejezés használatával.
DataColumn(String, Type)	Inicializálja az osztály új példányát a DataColumn megadott oszlopnév és adattípus használatával.
DataColumn(String)	Az osztály új példányát inicializálja DataColumn típussztringként a megadott oszlopnév használatával.

Tulajdonságok

Name	Description
AllowDBNull	Olyan értéket kap vagy állít be, amely azt jelzi, hogy a táblához tartozó sorok esetében engedélyezve vannak-e null értékek ebben az oszlopban.
AutoIncrement	Lekéri vagy beállít egy értéket, amely jelzi, hogy az oszlop automatikusan növeli-e a táblához hozzáadott új sorok oszlopának értékét.
AutoIncrementSeed	Lekéri vagy beállítja annak az oszlopnak a kezdőértékét, amelynek a tulajdonsága AutoIncrement be van állítva true. Az alapértelmezett érték a 0.
AutoIncrementStep	Lekéri vagy beállítja az oszlop által használt növekményt, amelynek tulajdonsága AutoIncrement a következőre truevan állítva: .
Caption	Lekéri vagy beállítja az oszlop feliratát.
ColumnMapping	Lekéri vagy beállítja az MappingType oszlopot.
ColumnName	Lekéri vagy beállítja az oszlop nevét a DataColumnCollection.
Container	Lekéri az összetevő tárolót. (Öröklődés forrása MarshalByValueComponent)
DataType	Lekéri vagy beállítja az oszlopban tárolt adatok típusát.
DateTimeMode	Lekéri vagy beállítja az DateTimeMode oszlopot.
DefaultValue	Új sorok létrehozásakor lekéri vagy beállítja az oszlop alapértelmezett értékét.
DesignMode	Egy értéket kap, amely jelzi, hogy az összetevő jelenleg tervezési módban van-e. (Öröklődés forrása MarshalByValueComponent)
Events	Lekéri az összetevőhöz csatolt eseménykezelők listáját. (Öröklődés forrása MarshalByValueComponent)
Expression	Lekéri vagy beállítja a sorok szűréséhez, az oszlopok értékeinek kiszámításához vagy összesített oszlop létrehozásához használt kifejezést.
ExtendedProperties	Lekéri a .-hoz társított egyéni felhasználói adatok gyűjteményét DataColumn.
MaxLength	Lekéri vagy beállítja egy szövegoszlop maximális hosszát.
Namespace	Lekéri vagy beállítja a névteret a DataColumn.
Ordinal	Lekéri a gyűjtemény oszlopának (nullaalapú) pozícióját DataColumnCollection .
Prefix	Lekéri vagy beállít egy XML-előtagot, amely aliasként használja a névteret.DataTable
ReadOnly	Lekéri vagy beállít egy értéket, amely jelzi, hogy az oszlop lehetővé teszi-e a módosításokat, amint egy sort hozzáadtak a táblához.
Site	Lekéri vagy beállítja az összetevő helyét. (Öröklődés forrása MarshalByValueComponent)
Table	Lekérdezi, DataTable hogy melyik oszlophoz tartozik.
Unique	Lekéri vagy beállít egy értéket, amely jelzi, hogy az oszlop egyes soraiban szereplő értékeknek egyedinek kell-e lenniük.

Metódusok

Name	Description
CheckNotAllowNull()	Ez a tag támogatja .NET infrastruktúrát, és nem közvetlenül a kódból való használatra szolgál.
CheckUnique()	Ez a tag támogatja .NET infrastruktúrát, és nem közvetlenül a kódból való használatra szolgál.
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)
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
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)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnPropertyChanging(PropertyChangedEventArgs)	Ez a tag támogatja .NET infrastruktúrát, és nem közvetlenül a kódból való használatra szolgál.
RaisePropertyChanging(String)	Ez a tag támogatja .NET infrastruktúrát, és nem közvetlenül a kódból való használatra szolgál.
SetOrdinal(Int32)	A megadott sorszámra vagy pozícióra módosítja a DataColumn sorszámot vagy a pozíciót.
ToString()	Lekéri az Expression oszlopot, ha van ilyen.

esemény

Name	Description
Disposed	Hozzáad egy eseménykezelőt az összetevő eseményének Disposed figyeléséhez. (Öröklődés forrása MarshalByValueComponent)

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

• Add(DataColumn)
• DataColumnCollection
• Constraints
• ConstraintCollection
• DataGrid
• DataRow
• DataTable
• DataSet
• NewRow()
• DataRowCollection
• UniqueConstraint
• Adatkészletek használata az ADO-ban.NET