DataColumn DataColumn DataColumn DataColumn Class

定義

DataTable の列のスキーマを表します。Represents the schema of a column in a DataTable.

public ref class DataColumn : System::ComponentModel::MarshalByValueComponent
public class DataColumn : System.ComponentModel.MarshalByValueComponent
type DataColumn = class
    inherit MarshalByValueComponent
Public Class DataColumn
Inherits MarshalByValueComponent
継承

次の例ではDataTable 、複数DataColumnのオブジェクトを使用してを作成します。The following example creates a DataTable with several DataColumn objects.

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

注釈

は、のスキーマを作成するための基本的なビルドブロックです。 DataTable DataColumnThe DataColumn is the fundamental building block for creating the schema of a DataTable. スキーマを作成するにはDataColumn 、に1つ以上のDataColumnCollectionオブジェクトを追加します。You build the schema by adding one or more DataColumn objects to the DataColumnCollection. 詳細については、「 DataTable への列の追加」を参照してください。For more information, see Adding Columns to a DataTable.

DataColumn には、にDataColumn含まれるデータの種類を決定するプロパティがあります。DataTypeEach DataColumn has a DataType property that determines the kind of data the DataColumn contains. たとえば、データ型を整数、文字列、または10進数に制限できます。For example, you can restrict the data type to integers, or strings, or decimals. に含まれるデータDataTableは、通常、元のデータソースにマージされるので、データ型をデータソース内のデータ型と一致させる必要があります。Because data that is contained by the DataTable is typically merged back into its original data source, you must match the data types to those in the data source. 詳細については、「 ADO.NET でのデータ型のマッピング」を参照してください。For more information, see Data Type Mappings in ADO.NET.

AllowDBNull、 、などReadOnlyのプロパティは、データの入力と更新に制限があるため、データの整合性を保証するのに役立ちます。 UniqueProperties such as AllowDBNull, Unique, and ReadOnly put restrictions on the entry and updating of data, thereby helping to guarantee data integrity. 、、およびAutoIncrement AutoIncrementSeedの各プロパティを使用して、自動データ生成を制御することAutoIncrementStepもできます。You can also use the AutoIncrement, AutoIncrementSeed, and AutoIncrementStep properties to control automatic data generation. AutoIncrement列の詳細については、「自動インクリメント列の作成」を参照してください。For more information about AutoIncrement columns, see Creating AutoIncrement Columns. 詳細については、「主キーの定義」を参照してください。For more information, see Defining Primary Keys.

DataColumnまた、をUniqueConstraint作成DataTableして、DataColumnが属するのに追加することで、の値が一意であることを確認することもできます。ConstraintCollectionYou can also make sure that values in a DataColumn are unique by creating a UniqueConstraint and adding it to the ConstraintCollection of the DataTable to which the DataColumn belongs. 詳細については、「 DataTable の制約」を参照してください。For more information, see DataTable Constraints.

オブジェクト間DataColumnのリレーションシップを作成するにはDataRelation 、オブジェクトを作成DataRelationCollectionし、のDataSetに追加します。To create a relation between DataColumn objects, create a DataRelation object and add it to the DataRelationCollection of a DataSet.

オブジェクトのプロパティExpressionを使用して、列の値を計算したり、集計列を作成したりできます。 DataColumnYou can use the Expression property of the DataColumn object to calculate the values in a column, or create an aggregate column. 詳細については、「式列の作成」を参照してください。For more information, see Creating Expression Columns.

コンストラクター

DataColumn() DataColumn() DataColumn() DataColumn()

DataColumn クラスの新しいインスタンスを文字列型として初期化します。Initializes a new instance of a DataColumn class as type string.

DataColumn(String) DataColumn(String) DataColumn(String) DataColumn(String)

指定した列名を使用して、DataColumn クラスの新しいインスタンスを文字列型として初期化します。Initializes a new instance of the DataColumn class, as type string, using the specified column name.

DataColumn(String, Type) DataColumn(String, Type) DataColumn(String, Type) DataColumn(String, Type)

指定した列名とデータ型を使用して DataColumn クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataColumn class using the specified column name and data type.

DataColumn(String, Type, String) DataColumn(String, Type, String) DataColumn(String, Type, String) DataColumn(String, Type, String)

指定した名前、データ型、および式を使用して DataColumn クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataColumn class using the specified name, data type, and expression.

DataColumn(String, Type, String, MappingType) DataColumn(String, Type, String, MappingType) DataColumn(String, Type, String, MappingType) DataColumn(String, Type, String, MappingType)

指定した名前、データ型、式、およびこの列が属性かどうかを決定する値を使用して、DataColumn クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataColumn class using the specified name, data type, expression, and value that determines whether the column is an attribute.

プロパティ

AllowDBNull AllowDBNull AllowDBNull AllowDBNull

このテーブルに属する行のこの列に null 値を格納できるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether null values are allowed in this column for rows that belong to the table.

AutoIncrement AutoIncrement AutoIncrement AutoIncrement

このテーブルに追加される新しい行でこの列の値を自動的にインクリメントするかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the column automatically increments the value of the column for new rows added to the table.

AutoIncrementSeed AutoIncrementSeed AutoIncrementSeed AutoIncrementSeed

AutoIncrement プロパティが true に設定されている列の開始値を取得または設定します。Gets or sets the starting value for a column that has its AutoIncrement property set to true. 既定値は 0 です。The default is 0.

AutoIncrementStep AutoIncrementStep AutoIncrementStep AutoIncrementStep

AutoIncrement プロパティが true に設定されている列で使用するインクリメント値を取得または設定します。Gets or sets the increment used by a column with its AutoIncrement property set to true.

Caption Caption Caption Caption

列のキャプションを取得または設定します。Gets or sets the caption for the column.

ColumnMapping ColumnMapping ColumnMapping ColumnMapping

列の MappingType を取得または設定します。Gets or sets the MappingType of the column.

ColumnName ColumnName ColumnName ColumnName

DataColumnCollection 内の列名を取得または設定します。Gets or sets the name of the column in the DataColumnCollection.

Container Container Container Container

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

(Inherited from MarshalByValueComponent)
DataType DataType DataType DataType

列に格納されているデータの型を取得または設定します。Gets or sets the type of data stored in the column.

DateTimeMode DateTimeMode DateTimeMode DateTimeMode

列の DateTimeMode を取得または設定します。Gets or sets the DateTimeMode for the column.

DefaultValue DefaultValue DefaultValue DefaultValue

新しい行を作成するときに使用されるこの列の既定値を取得または設定します。Gets or sets the default value for the column when you are creating new rows.

DesignMode DesignMode DesignMode DesignMode

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

(Inherited from MarshalByValueComponent)
Events Events Events Events

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

(Inherited from MarshalByValueComponent)
Expression Expression Expression Expression

行のフィルター処理、列内の値の計算、または集約列の作成に使用する式を取得または設定します。Gets or sets the expression used to filter rows, calculate the values in a column, or create an aggregate column.

ExtendedProperties ExtendedProperties ExtendedProperties ExtendedProperties

DataColumn に関連付けられているカスタム ユーザー情報のコレクションを取得します。Gets the collection of custom user information associated with a DataColumn.

MaxLength MaxLength MaxLength MaxLength

テキスト列の最大長を取得または設定します。Gets or sets the maximum length of a text column.

Namespace Namespace Namespace Namespace

DataColumn の名前空間を取得または設定します。Gets or sets the namespace of the DataColumn.

Ordinal Ordinal Ordinal Ordinal

DataColumnCollection コレクション内の 0 から始まる列の位置を取得します。Gets the (zero-based) position of the column in the DataColumnCollection collection.

Prefix Prefix Prefix Prefix

DataTable の名前空間に別名を付ける XML プリフィックスを取得または設定します。Gets or sets an XML prefix that aliases the namespace of the DataTable.

ReadOnly ReadOnly ReadOnly ReadOnly

行がテーブルに追加された直後にこの列を変更できるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the column allows for changes as soon as a row has been added to the table.

Site Site Site Site

コンポーネントのサイトを取得または設定します。Gets or sets the site of the component.

(Inherited from MarshalByValueComponent)
Table Table Table Table

列が属する DataTable を取得します。Gets the DataTable to which the column belongs to.

Unique Unique Unique Unique

列の各行の値が一意である必要があるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the values in each row of the column must be unique.

メソッド

CheckNotAllowNull() CheckNotAllowNull() CheckNotAllowNull() CheckNotAllowNull()

このメンバーは .NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

CheckUnique() CheckUnique() CheckUnique() CheckUnique()

このメンバーは .NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

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)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
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)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs)

このメンバーは .NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String)

このメンバーは .NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

SetOrdinal(Int32) SetOrdinal(Int32) SetOrdinal(Int32) SetOrdinal(Int32)

DataColumn の序数または位置を、指定された序数または位置に変更します。Changes the ordinal or position of the DataColumn to the specified ordinal or position.

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

列の Expression がある場合は、その式を取得します。Gets the Expression of the column, if one exists.

イベント

Disposed Disposed Disposed Disposed

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

(Inherited from MarshalByValueComponent)

適用対象

スレッド セーフ

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

こちらもご覧ください