DataColumn 類別

參考

定義

命名空間:: System.Data

組件:: System.Data.Common.dll

組件:: System.Data.dll

組件:: netstandard.dll

來源:: DataColumn.cs

來源:: DataColumn.cs

來源:: DataColumn.cs

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

表示 DataTable 中資料行的結構描述。

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

public class DataColumn : System.ComponentModel.MarshalByValueComponent

type DataColumn = class
    inherit MarshalByValueComponent

Public Class DataColumn
Inherits MarshalByValueComponent

繼承: Object

MarshalByValueComponent
DataColumn

範例

下列範例會建立具有數DataColumn個 DataTable 物件的。

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

備註

DataColumn是用來建立架構DataTable的基本建置組塊。您可以藉由將一或多個 DataColumn 物件新增至 DataColumnCollection來建置架構。如需詳細資訊，請參閱將數據行新增至 DataTable。

每個 DataColumn 都有一個 DataType 屬性，可決定包含的數據 DataColumn 種類。例如，您可以將數據類型限製為整數、字串或小數點。由於所包含的 DataTable 數據通常會合併回其原始數據源，因此您必須將數據類型與數據源中的數據類型相符。如需詳細資訊，請參閱 ADO.NET 中的數據類型對應。

、 Unique和 ReadOnly 等AllowDBNull屬性會限制專案和更新數據，進而協助保證數據完整性。您也可以使用 AutoIncrement、 AutoIncrementSeed和 AutoIncrementStep 屬性來控制自動資料產生。如需數據行的詳細資訊 AutoIncrement ，請參閱建立自動建立數據行。如需詳細資訊，請參閱定義主索引鍵。

您也可以建立，UniqueConstraint並將其新增至ConstraintCollection所屬的 DataColumn DataTable ，以確保中的DataColumn值是唯一的。如需詳細資訊，請參閱 DataTable 條件約束。

若要建立物件之間的 DataColumn 關聯性，請建立 DataRelation 物件，並將它新增至 DataRelationCollection 的 DataSet。

您可以使用 Expression 物件的屬性 DataColumn 來計算數據列中的值，或建立匯總數據行。如需詳細資訊，請參閱建立表達式數據行。

建構函式

DataColumn()	將類別的新實例 DataColumn 初始化為類型字串。
DataColumn(String)	使用指定的資料行名稱，初始化 DataColumn 類別的新執行個體為類型字串。
DataColumn(String, Type)	使用指定的資料行名稱和資料類型，初始化 DataColumn 類別的新執行個體。
DataColumn(String, Type, String)	使用指定的名稱、資料型別和運算式，初始化 DataColumn 類別的新執行個體。
DataColumn(String, Type, String, MappingType)	使用指定名稱、資料型別、運算式和判斷資料行是否是屬性 (Attribute) 的值，初始化 DataColumn 類別的新執行個體。

屬性

AllowDBNull	取得或設定值，指出對於屬於資料表的資料列而言，這個資料行中是否允許 Null 值。
AutoIncrement	取得或設定值，指出對於加入至資料表的新資料列而言，該資料行是否自動遞增資料行的值。
AutoIncrementSeed	取得或設定資料行的開始值，這個資料行的 AutoIncrement 屬性設定為 `true`。預設值是 0。
AutoIncrementStep	取得或設定資料行所使用的遞增，這個資料行的 AutoIncrement 屬性設定為 `true`。
Caption	取得或設定資料行的標題。
ColumnMapping	取得或設定資料行的 MappingType。
ColumnName	取得或設定在 DataColumnCollection 中的資料行名稱。
Container	取得元件的容器。 (繼承來源 MarshalByValueComponent)
DataType	取得或設定儲存在資料行中的資料型別。
DateTimeMode	取得或設定資料行的 `DateTimeMode`。
DefaultValue	在建立新資料列時，取得或設定資料行的預設值。
DesignMode	取得值，表示元件目前是否處於設計模式。 (繼承來源 MarshalByValueComponent)
Events	取得附加在這個元件上的事件處理常式清單。 (繼承來源 MarshalByValueComponent)
Expression	取得或設定運算式，用來篩選資料列、計算資料行中的值或建立彙總資料行。
ExtendedProperties	取得與 DataColumn 相關聯的自訂使用者資訊集合。
MaxLength	取得或設定文字資料行的最大長度。
Namespace	取得或設定 DataColumn 的命名空間。
Ordinal	取得 DataColumnCollection 集合中 (以零起始) 的資料行位置。
Prefix	取得或設定建立 DataTable 命名空間別名的 XML 前置詞。
ReadOnly	取得或設定值，指出是否資料列一加入至資料表，就允許變更資料行。
Site	取得或設定元件的網站。 (繼承來源 MarshalByValueComponent)
Table	取得資料行所屬的 DataTable。
Unique	取得或設定值，指出在資料行之每個資料列中的值是否必須是唯一的。

方法

CheckNotAllowNull()	這個成員支援 .NET 基礎結構，而且不適合直接從程式碼使用。
CheckUnique()	這個成員支援 .NET 基礎結構，而且不適合直接從程式碼使用。
Dispose()	釋放 MarshalByValueComponent 所使用的所有資源。 (繼承來源 MarshalByValueComponent)
Dispose(Boolean)	釋放 MarshalByValueComponent 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 MarshalByValueComponent)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetService(Type)	取得 IServiceProvider 的實作器。 (繼承來源 MarshalByValueComponent)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnPropertyChanging(PropertyChangedEventArgs)	這個成員支援 .NET 基礎結構，而且不適合直接從程式碼使用。
RaisePropertyChanging(String)	這個成員支援 .NET 基礎結構，而且不適合直接從程式碼使用。
SetOrdinal(Int32)	將 DataColumn 的序數或位置變更為指定的序數或位置。
ToString()	取得資料行的 Expression (如果存在)。

事件

Disposed

加入事件處理常式來接聽元件上的 Disposed 事件。

(繼承來源 MarshalByValueComponent)

擴充方法

GetKeyedService<T>(IServiceProvider, Object)	從IServiceProvider取得型`T`別的服務。
GetKeyedServices(IServiceProvider, Type, Object)	從IServiceProvider取得型`serviceType`別服務的列舉。
GetKeyedServices<T>(IServiceProvider, Object)	從IServiceProvider取得型`T`別服務的列舉。
GetRequiredKeyedService(IServiceProvider, Type, Object)	從IServiceProvider取得型`serviceType`別的服務。
GetRequiredKeyedService<T>(IServiceProvider, Object)	從IServiceProvider取得型`T`別的服務。
CreateAsyncScope(IServiceProvider)	建立可用來解析已設定範圍服務的新 AsyncServiceScope。
CreateScope(IServiceProvider)	建立可用來解析已設定範圍服務的新 IServiceScope。
GetRequiredService(IServiceProvider, Type)	從 IServiceProvider 取得 `serviceType` 類型的服務。
GetRequiredService<T>(IServiceProvider)	從 IServiceProvider 取得 `T` 類型的服務。
GetService<T>(IServiceProvider)	從 IServiceProvider 取得 `T` 類型的服務。
GetServices(IServiceProvider, Type)	從 IServiceProvider 取得類型 `serviceType` 服務的列舉。
GetServices<T>(IServiceProvider)	從 IServiceProvider 取得類型 `T` 服務的列舉。
GetFakeLogCollector(IServiceProvider)	取得對象，這個物件會收集傳送至假記錄器的記錄檔記錄。
GetFakeRedactionCollector(IServiceProvider)	從相依性插入容器取得假的重構函式收集器實例。

適用於

執行緒安全性

此類型適用於多線程讀取作業。您必須同步處理任何寫入作業。

共用方式為

DataColumn 類別

定義

範例

備註

建構函式

屬性

方法

事件

擴充方法

適用於

執行緒安全性

另請參閱

其他資源