DataColumnCollection.Add 메서드

정의

네임스페이스:

System.Data

어셈블리:

System.Data.Common.dll

DataColumn 개체를 만든 다음 DataColumnCollection에 추가합니다.

오버로드

Add()	DataColumn 개체를 만든 다음 DataColumnCollection에 추가합니다.
Add(DataColumn)	지정된 DataColumn 개체를 만든 다음 DataColumnCollection에 추가합니다.
Add(String)	지정된 이름의 DataColumn 개체를 만들어 DataColumnCollection에 추가합니다.
Add(String, Type)	지정된 이름과 형식의 DataColumn 개체를 만들어 DataColumnCollection에 추가합니다.
Add(String, Type, String)	지정된 이름, 형식 및 식의 DataColumn 개체를 만들어 DataColumnCollection에 추가합니다.

Add()

Source:

DataColumnCollection.cs

DataColumn 개체를 만든 다음 DataColumnCollection에 추가합니다.

public:
 System::Data::DataColumn ^ Add();

public System.Data.DataColumn Add ();

member this.Add : unit -> System.Data.DataColumn

Public Function Add () As DataColumn

반환

DataColumn

새로 만든 DataColumn입니다.

예제

다음 예제에서는 를 만들고 의 에 새 DataColumn 를 DataColumnCollectionDataTable추가합니다.

Private Sub AddColumn()
    ' Get the DataColumnCollection from a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Prices").Columns
    Dim column As DataColumn = columns.Add()

    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ColumnName = "Total"
       .Expression = "UnitPrice * Quantity"
       .ReadOnly = True
       .Unique = False
    End With
End Sub

설명

열에 기본 이름("Column1", "Column2" 등)이 지정됩니다.

열을 CollectionChanged 추가하거나 제거하여 컬렉션을 성공적으로 변경하면 이벤트가 발생합니다.

추가 정보

• ColumnName
• Contains(String)
• DataType
• Expression

Add(DataColumn)

Source:

DataColumnCollection.cs

지정된 DataColumn 개체를 만든 다음 DataColumnCollection에 추가합니다.

public:
 void Add(System::Data::DataColumn ^ column);

public void Add (System.Data.DataColumn column);

member this.Add : System.Data.DataColumn -> unit

Public Sub Add (column As DataColumn)

매개 변수

column

DataColumn

추가할 DataColumn입니다.

예외

ArgumentNullException

column 매개 변수가 null인 경우

ArgumentException

열이 이 컬렉션이나 다른 컬렉션에 이미 속해 있는 경우

DuplicateNameException

지정된 이름의 열이 컬렉션에 이미 있는 경우. (대/소문자를 구분하지 않고 비교합니다.)

InvalidExpressionException

식이 잘못되었습니다. 식을 만드는 방법에 대한 자세한 내용은 Expression 속성을 참조하십시오.

예제

다음 예제에서는 에 를 DataColumn 추가합니다 DataColumnCollection.

Private Sub AddDataColumn()
    ' Get the DataColumnCollection from a DataTable in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns
 
    Dim column As New DataColumn()
    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ColumnName = "ItemPrice"
       .Caption = "Price"
       .ReadOnly = False
       .Unique = False
       .DefaultValue = 0
    End With
    columns.Add(column)
End Sub

설명

열을 CollectionChanged 추가하거나 제거하여 컬렉션을 성공적으로 변경하면 이벤트가 발생합니다.

추가 정보

• ColumnName
• CollectionChanged
• Contains(String)
• DataType
• Expression

Add(String)

Source:

DataColumnCollection.cs

지정된 이름의 DataColumn 개체를 만들어 DataColumnCollection에 추가합니다.

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName);

public System.Data.DataColumn Add (string? columnName);

member this.Add : string -> System.Data.DataColumn

Public Function Add (columnName As String) As DataColumn

매개 변수

columnName

String

열 이름입니다.

반환

DataColumn

새로 만든 DataColumn입니다.

예외

DuplicateNameException

지정된 이름의 열이 컬렉션에 이미 있는 경우. (대/소문자를 구분하지 않고 비교합니다.)

예제

다음 예제에서는 를 만들고 의 에 새 DataColumn 를 DataColumnCollectionDataTable추가합니다.

Private Sub AddColumn()
    ' Get the DataColumnCollection from a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Prices").Columns
    Dim column As DataColumn = columns.Add("Total")

    With column
       .DataType = System.Type.GetType("System.Decimal")
       .ReadOnly = True
       .Expression = "UnitPrice * Quantity"
       .Unique = False
    End With
End Sub

설명

기본적으로 DataType 새 열의 은 입니다 string.

또는 빈 문자열("")이 이름에 전달되면 null 기본 이름("Column1", "Column2" 등)이 열에 지정됩니다.

메서드를 Contains 사용하여 제안된 이름의 열이 컬렉션에 이미 있는지 여부를 확인합니다.

열을 CollectionChanged 추가하거나 제거하여 컬렉션을 성공적으로 변경하면 이벤트가 발생합니다.

추가 정보

• ColumnName
• Contains(String)
• DataType
• Expression

Add(String, Type)

Source:

DataColumnCollection.cs

지정된 이름과 형식의 DataColumn 개체를 만들어 DataColumnCollection에 추가합니다.

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);

public System.Data.DataColumn Add (string? columnName, Type type);

member this.Add : string * Type -> System.Data.DataColumn

Public Function Add (columnName As String, type As Type) As DataColumn

매개 변수

columnName

String

열을 만들 때 사용할 ColumnName입니다.

type

Type

새 열의 DataType입니다.

반환

DataColumn

새로 만든 DataColumn입니다.

예외

DuplicateNameException

지정된 이름의 열이 컬렉션에 이미 있는 경우. (대/소문자를 구분하지 않고 비교합니다.)

InvalidExpressionException

식이 잘못되었습니다. 식을 만드는 방법에 대한 자세한 내용은 Expression 속성을 참조하십시오.

예제

다음 예제에서는 를 만들고 의 에 새 DataColumn 를 DataColumnCollectionDataTable추가합니다.

Private Sub AddColumn()
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns
 
    ' Add a new column and return it.
    Dim column As DataColumn = columns.Add( _
        "Total", System.Type.GetType("System.Decimal"))
    column.ReadOnly = True
    column.Unique = False
End Sub

설명

또는 빈 문자열("")이 이름에 전달되면 null 기본 이름("Column1", "Column2" 등)이 열에 지정됩니다.

메서드를 Contains 사용하여 제안된 이름의 열이 컬렉션에 이미 있는지 여부를 확인합니다.

열을 CollectionChanged 추가하거나 제거하여 컬렉션을 성공적으로 변경하면 이벤트가 발생합니다.

추가 정보

• ColumnName
• DataType
• Expression

Add(String, Type, String)

Source:

DataColumnCollection.cs

지정된 이름, 형식 및 식의 DataColumn 개체를 만들어 DataColumnCollection에 추가합니다.

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);

public System.Data.DataColumn Add (string? columnName, Type type, string expression);

member this.Add : string * Type * string -> System.Data.DataColumn

Public Function Add (columnName As String, type As Type, expression As String) As DataColumn

매개 변수

columnName

String

열을 만들 때 사용할 이름입니다.

type

Type

새 열의 DataType입니다.

expression

String

Expression 속성에 할당할 식입니다.

반환

DataColumn

새로 만든 DataColumn입니다.

예외

DuplicateNameException

지정된 이름의 열이 컬렉션에 이미 있는 경우. (대/소문자를 구분하지 않고 비교합니다.)

InvalidExpressionException

식이 잘못되었습니다. 식을 만드는 방법에 대한 자세한 내용은 Expression 속성을 참조하십시오.

예제

다음 예제에서는 를 만들고 의 에 새 DataColumn 를 DataColumnCollectionDataTable추가합니다.

Private Sub AddColumn()
    ' Get the DataColumnCollection of a table in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns

    ' Add a new column and return it.
    Dim column As DataColumn = _
        columns.Add("Total", System.Type.GetType( _
        "System.Decimal"), "Price + Tax")
    column.ReadOnly = True
    column.Unique = False
 End Sub

설명

또는 빈 문자열("")이 이름에 전달되면 null 기본 이름("Column1", "Column2" 등)이 열에 지정됩니다.

메서드를 Contains 사용하여 제안된 이름의 열이 컬렉션에 이미 있는지 여부를 확인합니다.

열을 CollectionChanged 추가하거나 제거하여 컬렉션을 성공적으로 변경하면 이벤트가 발생합니다.

추가 정보

• ColumnName
• Contains(String)
• DataType
• Expression