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

설명

합니다 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

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.

추가 정보