DataColumn 클래스

정의

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
상속

예제

다음 예에서는 여러 DataColumn 개체가 포함 된 DataTable를 만듭니다.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

설명

DataColumnDataTable의 스키마를 만들기 위한 기본 구성 요소입니다.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.

DataColumn에는 DataColumn에 포함 되는 데이터의 종류를 결정 하는 DataType 속성이 있습니다.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, UniqueReadOnly와 같은 속성은 데이터의 입력과 업데이트를 제한 하 여 데이터 무결성을 보장 하는 데 도움이 됩니다.Properties such as AllowDBNull, Unique, and ReadOnly put restrictions on the entry and updating of data, thereby helping to guarantee data integrity. AutoIncrement, AutoIncrementSeedAutoIncrementStep 속성을 사용 하 여 자동 데이터 생성을 제어할 수도 있습니다.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.

UniqueConstraint을 만들고 DataColumn가 속한 DataTableConstraintCollection에 추가 하 여 DataColumn의 값이 고유한 지 확인할 수도 있습니다.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 개체를 만들어 DataSetDataRelationCollection에 추가 합니다.To create a relation between DataColumn objects, create a DataRelation object and add it to the DataRelationCollection of a DataSet.

DataColumn 개체의 Expression 속성을 사용 하 여 열의 값을 계산 하거나 집계 열을 만들 수 있습니다.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 클래스의 새 인스턴스를 형식 문자열로 초기화합니다.Initializes a new instance of a DataColumn class as type string.

DataColumn(String)

지정된 열 이름을 사용하여 DataColumn 클래스의 새 인스턴스를 형식 문자열로 초기화합니다.Initializes a new instance of the DataColumn class, as type string, using the specified column name.

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 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the DataColumn class using the specified name, data type, and expression.

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

테이블에 속해 있는 행의 이 열에 null 값이 허용되는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether null values are allowed in this column for rows that belong to the table.

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

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

AutoIncrement 속성이 true로 설정된 열에 사용되는 증분을 가져오거나 설정합니다.Gets or sets the increment used by a column with its AutoIncrement property set to true.

Caption

열의 캡션을 가져오거나 설정합니다.Gets or sets the caption for the column.

ColumnMapping

열의 MappingType을 가져오거나 설정합니다.Gets or sets the MappingType of the column.

ColumnName

DataColumnCollection의 열 이름을 가져오거나 설정합니다.Gets or sets the name of the column in the DataColumnCollection.

Container

구성 요소의 컨테이너를 가져옵니다.Gets the container for the component.

(다음에서 상속됨 MarshalByValueComponent)
DataType

열에 저장된 데이터의 형식을 가져오거나 설정합니다.Gets or sets the type of data stored in the column.

DateTimeMode

열의 DateTimeMode를 가져오거나 설정합니다.Gets or sets the DateTimeMode for the column.

DefaultValue

새 행을 만들 때 열에 대 한 기본 값을 가져오거나 설정 합니다.Gets or sets the default value for the column when you are creating new rows.

DesignMode

구성 요소가 현재 디자인 모드에 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the component is currently in design mode.

(다음에서 상속됨 MarshalByValueComponent)
Events

이 구성 요소에 연결된 이벤트 처리기의 목록을 가져옵니다.Gets the list of event handlers that are attached to this component.

(다음에서 상속됨 MarshalByValueComponent)
Expression

행을 필터링, 열에 값을 계산 하거나 집계 열을 만드는 데 식을 가져오거나 설정 합니다.Gets or sets the expression used to filter rows, calculate the values in a column, or create an aggregate column.

ExtendedProperties

DataColumn과 관련된 사용자 지정 사용자 정보 컬렉션을 가져옵니다.Gets the collection of custom user information associated with a DataColumn.

MaxLength

텍스트 열의 최대 길이를 가져오거나 설정합니다.Gets or sets the maximum length of a text column.

Namespace

DataColumn의 네임스페이스를 가져오거나 설정합니다.Gets or sets the namespace of the DataColumn.

Ordinal

DataColumnCollection 컬렉션에서 0부터 시작하는 열의 위치를 가져옵니다.Gets the (zero-based) position of the column in the DataColumnCollection collection.

Prefix

DataTable 네임스페이스의 별칭인 XML 접두사를 가져오거나 설정합니다.Gets or sets an XML prefix that aliases the namespace of the DataTable.

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

구성 요소의 사이트를 가져오거나 설정합니다.Gets or sets the site of the component.

(다음에서 상속됨 MarshalByValueComponent)
Table

열이 속한 DataTable을 가져옵니다.Gets the DataTable to which the column belongs to.

Unique

열의 각 행의 값이 고유 해야 하는지 여부를 나타내는 값을 가져오거나 설정 합니다.Gets or sets a value that indicates whether the values in each row of the column must be unique.

메서드

CheckNotAllowNull()

이 멤버는 .NET Framework 인프라를 지원하며 사용자 코드에서 직접 사용할 수 없습니다.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

CheckUnique()

이 멤버는 .NET Framework 인프라를 지원하며 사용자 코드에서 직접 사용할 수 없습니다.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Dispose()

MarshalByValueComponent에서 사용한 모든 리소스를 해제합니다.Releases all resources used by the MarshalByValueComponent.

(다음에서 상속됨 MarshalByValueComponent)
Dispose(Boolean)

MarshalByValueComponent에서 사용한 관리되지 않는 리소스를 해제하고 선택적으로 관리되는 리소스를 해제합니다.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(다음에서 상속됨 MarshalByValueComponent)
Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetService(Type)

IServiceProvider의 구현자를 가져옵니다.Gets the implementer of the IServiceProvider.

(다음에서 상속됨 MarshalByValueComponent)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
OnPropertyChanging(PropertyChangedEventArgs)

이 멤버는 .NET Framework 인프라를 지원하며 사용자 코드에서 직접 사용할 수 없습니다.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

RaisePropertyChanging(String)

이 멤버는 .NET Framework 인프라를 지원하며 사용자 코드에서 직접 사용할 수 없습니다.This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

SetOrdinal(Int32)

DataColumn의 서수나 위치를 지정된 서수나 위치로 변경합니다.Changes the ordinal or position of the DataColumn to the specified ordinal or position.

ToString()

열의 Expression이 있으면 가져옵니다.Gets the Expression of the column, if one exists.

이벤트

Disposed

구성 요소에 대한 Disposed 이벤트를 수신하는 이벤트 처리기를 추가합니다.Adds an event handler to listen to the Disposed event on the component.

(다음에서 상속됨 MarshalByValueComponent)

적용 대상

스레드 보안

이 유형은 다중 스레드 읽기 작업에 안전 합니다.This type is safe for multithreaded read operations. 모든 쓰기 작업을 동기화 해야 합니다.You must synchronize any write operations.

추가 정보