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. 하나 이상의 추가 하 여 스키마를 빌드하면 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.

DataColumnDataType 데이터의 종류를 결정 하는 속성을 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.

와 같은 속성 AllowDBNull, Unique, 및 ReadOnly 항목 및 데이터 무결성을 보장 하도록 함으로써 이러한 데이터의 업데이트에 대 한 제한 배치 합니다.Properties 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 열을 참조 하세요 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

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.

추가 정보