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 DataTable = new DataTable("Product") 

    ' Create a DataColumn and set various properties. 
    Dim column As DataColumn = 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します。The DataColumn is the fundamental building block for creating the schema of a DataTable. 1 つまたは複数を追加して、スキーマを構築するDataColumnオブジェクトを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が、DataTypeデータの種類を決定するプロパティ、DataColumnが含まれています。Each 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.

などのプロパティAllowDBNullUnique、およびReadOnlyエントリとのデータの整合性を保証するデータの更新に関する制限事項を配置します。Properties such as AllowDBNull, Unique, and ReadOnly put restrictions on the entry and updating of data, thereby helping to guarantee data integrity. 使用することも、 AutoIncrementAutoIncrementSeed、およびAutoIncrementStepプロパティ データの自動生成を制御します。You can also use the AutoIncrement, AutoIncrementSeed, and AutoIncrementStep properties to control automatic data generation. 詳細についてはAutoIncrement列を参照してくださいAutoIncrement 列の作成です。For more information about AutoIncrement columns, see Creating AutoIncrement Columns. 詳細については、次を参照してください。主キーを定義するします。For more information, see Defining Primary Keys.

値を確認することもできます、DataColumnが一意で、作成、UniqueConstraintに追加することと、ConstraintCollectionDataTableDataColumnが属しています。You 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し、オブジェクトに追加、DataRelationCollectionDataSetします。To create a relation between DataColumn objects, create a DataRelation object and add it to the DataRelationCollection of a DataSet.

使用することができます、Expressionのプロパティ、DataColumnオブジェクトを列の値を計算または集計列を作成します。You 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

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

Prefix Prefix Prefix Prefix

XML プレフィックスその別名の名前空間を取得または設定、DataTableします。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.

こちらもご覧ください