DataColumnCollection.Add 메서드

정의

DataColumn 개체를 만든 다음 DataColumnCollection에 추가합니다.Creates and adds a DataColumn object to the DataColumnCollection.

오버로드

Add()

DataColumn 개체를 만든 다음 DataColumnCollection에 추가합니다.Creates and adds a DataColumn object to the DataColumnCollection.

Add(DataColumn)

지정된 DataColumn 개체를 만든 다음 DataColumnCollection에 추가합니다.Creates and adds the specified DataColumn object to the DataColumnCollection.

Add(String)

지정된 이름의 DataColumn 개체를 만들어 DataColumnCollection에 추가합니다.Creates and adds a DataColumn object that has the specified name to the DataColumnCollection.

Add(String, Type)

지정된 이름과 형식의 DataColumn 개체를 만들어 DataColumnCollection에 추가합니다.Creates and adds a DataColumn object that has the specified name and type to the DataColumnCollection.

Add(String, Type, String)

지정된 이름, 형식 및 식의 DataColumn 개체를 만들어 DataColumnCollection에 추가합니다.Creates and adds a DataColumn object that has the specified name, type, and expression to the DataColumnCollection.

Add()

DataColumn 개체를 만든 다음 DataColumnCollection에 추가합니다.Creates and adds a DataColumn object to the DataColumnCollection.

public:
 System::Data::DataColumn ^ Add();
public:
 virtual System::Data::DataColumn ^ Add();
public System.Data.DataColumn Add ();
public virtual System.Data.DataColumn Add ();
member this.Add : unit -> System.Data.DataColumn
abstract member Add : unit -> System.Data.DataColumn
override this.Add : unit -> System.Data.DataColumn
Public Function Add () As DataColumn
Public Overridable Function Add () As DataColumn

반환

새로 만든 DataColumn입니다.The newly created DataColumn.

예제

다음 예에서는 DataTableDataColumnCollection에 새 DataColumn를 만들어 추가 합니다.The following example creates and adds a new DataColumn to the DataColumnCollection of a DataTable.

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" 등) 기본 이름이 열에 지정 됩니다.A default name ("Column1", "Column2", and so on) is given to the column.

열을 추가 하거나 제거 하 여 컬렉션을 성공적으로 변경 하면 CollectionChanged 이벤트가 발생 합니다.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

추가 정보

Add(DataColumn)

지정된 DataColumn 개체를 만든 다음 DataColumnCollection에 추가합니다.Creates and adds the specified DataColumn object to the 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입니다.The DataColumn to add.

예외

column 매개 변수는 null입니다.The column parameter is null.

열이 이 컬렉션이나 다른 컬렉션에 이미 속해 있는 경우The column already belongs to this collection, or to another collection.

컬렉션에 이미 지정 된 이름의 열을 있습니다.The collection already has a column with the specified name. (대/소문자를 구분하지 않고 비교합니다.)(The comparison is not case-sensitive.)

식이 잘못되었습니다.The expression is invalid. 식을 만드는 방법에 대한 자세한 내용은 Expression 속성을 참조하십시오.See the Expression property for more information about how to create expressions.

예제

다음 예에서는 DataColumnCollectionDataColumn를 추가 합니다.The following example adds a DataColumn to a 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 이벤트가 발생 합니다.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

추가 정보

Add(String)

지정된 이름의 DataColumn 개체를 만들어 DataColumnCollection에 추가합니다.Creates and adds a DataColumn object that has the specified name to the DataColumnCollection.

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName);
public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName);
public System.Data.DataColumn Add (string columnName);
public virtual System.Data.DataColumn Add (string columnName);
member this.Add : string -> System.Data.DataColumn
abstract member Add : string -> System.Data.DataColumn
override this.Add : string -> System.Data.DataColumn
Public Function Add (columnName As String) As DataColumn
Public Overridable Function Add (columnName As String) As DataColumn

매개 변수

columnName
String

열 이름입니다.The name of the column.

반환

새로 만든 DataColumn입니다.The newly created DataColumn.

예외

컬렉션에 이미 지정 된 이름의 열을 있습니다.The collection already has a column with the specified name. (대/소문자를 구분하지 않고 비교합니다.)(The comparison is not case-sensitive.)

예제

다음 예에서는 DataTableDataColumnCollection에 새 DataColumn를 만들어 추가 합니다.The following example creates and adds a new DataColumn to a DataColumnCollection of a DataTable.

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됩니다.By default, the DataType for the new column is string.

null 또는 이름에 대해 빈 문자열 ("")이 전달 되 면 열에 기본 이름 ("Column1", "Column2" 등)이 지정 됩니다.If null or an empty string ("") is passed in for the name, a default name ("Column1", "Column2", and so on) is given to the column.

Contains 메서드를 사용 하 여 제안 된 이름의 열이 컬렉션에 이미 있는지 여부를 확인 합니다.Use the Contains method to determine whether a column with the proposed name already exists in the collection.

열을 추가 하거나 제거 하 여 컬렉션을 성공적으로 변경 하면 CollectionChanged 이벤트가 발생 합니다.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

추가 정보

Add(String, Type)

지정된 이름과 형식의 DataColumn 개체를 만들어 DataColumnCollection에 추가합니다.Creates and adds a DataColumn object that has the specified name and type to the DataColumnCollection.

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);
public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type);
public System.Data.DataColumn Add (string columnName, Type type);
public virtual System.Data.DataColumn Add (string columnName, Type type);
member this.Add : string * Type -> System.Data.DataColumn
abstract member Add : string * Type -> System.Data.DataColumn
override this.Add : string * Type -> System.Data.DataColumn
Public Function Add (columnName As String, type As Type) As DataColumn
Public Overridable Function Add (columnName As String, type As Type) As DataColumn

매개 변수

columnName
String

열을 만들 때 사용할 ColumnName입니다.The ColumnName to use when you create the column.

type
Type

새 열의 DataType입니다.The DataType of the new column.

반환

새로 만든 DataColumn입니다.The newly created DataColumn.

예외

컬렉션에 이미 지정 된 이름의 열을 있습니다.The collection already has a column with the specified name. (대/소문자를 구분하지 않고 비교합니다.)(The comparison is not case-sensitive.)

식이 잘못되었습니다.The expression is invalid. 식을 만드는 방법에 대한 자세한 내용은 Expression 속성을 참조하십시오.See the Expression property for more information about how to create expressions.

예제

다음 예에서는 DataTableDataColumnCollection에 새 DataColumn를 만들어 추가 합니다.The following example creates and adds a new DataColumn to a DataColumnCollection of a DataTable.

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" 등)이 지정 됩니다.If null or an empty string ("") is passed in for the name, a default name ("Column1", "Column2", and so on) is given to the column.

Contains 메서드를 사용 하 여 제안 된 이름의 열이 컬렉션에 이미 있는지 여부를 확인 합니다.Use the Contains method to determine whether a column with the proposed name already exists in the collection.

열을 추가 하거나 제거 하 여 컬렉션을 성공적으로 변경 하면 CollectionChanged 이벤트가 발생 합니다.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

추가 정보

Add(String, Type, String)

지정된 이름, 형식 및 식의 DataColumn 개체를 만들어 DataColumnCollection에 추가합니다.Creates and adds a DataColumn object that has the specified name, type, and expression to the DataColumnCollection.

public:
 System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);
public:
 virtual System::Data::DataColumn ^ Add(System::String ^ columnName, Type ^ type, System::String ^ expression);
public System.Data.DataColumn Add (string columnName, Type type, string expression);
public virtual System.Data.DataColumn Add (string columnName, Type type, string expression);
member this.Add : string * Type * string -> System.Data.DataColumn
abstract member Add : string * Type * string -> System.Data.DataColumn
override this.Add : string * Type * string -> System.Data.DataColumn
Public Function Add (columnName As String, type As Type, expression As String) As DataColumn
Public Overridable Function Add (columnName As String, type As Type, expression As String) As DataColumn

매개 변수

columnName
String

열을 만들 때 사용할 이름입니다.The name to use when you create the column.

type
Type

새 열의 DataType입니다.The DataType of the new column.

expression
String

Expression 속성에 할당할 식입니다.The expression to assign to the Expression property.

반환

새로 만든 DataColumn입니다.The newly created DataColumn.

예외

컬렉션에 이미 지정 된 이름의 열을 있습니다.The collection already has a column with the specified name. (대/소문자를 구분하지 않고 비교합니다.)(The comparison is not case-sensitive.)

식이 잘못되었습니다.The expression is invalid. 식을 만드는 방법에 대한 자세한 내용은 Expression 속성을 참조하십시오.See the Expression property for more information about how to create expressions.

예제

다음 예에서는 DataTableDataColumnCollection에 새 DataColumn를 만들어 추가 합니다.The following example creates and adds a new DataColumn to a DataColumnCollection of a DataTable.

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" 등)이 지정 됩니다.If null or an empty string ("") is passed in for the name, a default name ("Column1", "Column2", and so on) is given to the column.

Contains 메서드를 사용 하 여 제안 된 이름의 열이 컬렉션에 이미 있는지 여부를 확인 합니다.Use the Contains method to determine whether a column with the proposed name already exists in the collection.

열을 추가 하거나 제거 하 여 컬렉션을 성공적으로 변경 하면 CollectionChanged 이벤트가 발생 합니다.If the collection is successfully changed by adding or removing columns, the CollectionChanged event occurs.

추가 정보

적용 대상