DataColumnCollection.Remove 메서드

정의

네임스페이스:

System.Data

어셈블리:

System.Data.dll

DataColumn 컬렉션에서 개체를 제거합니다.

오버로드

Name	Description
Remove(DataColumn)	컬렉션에서 지정된 DataColumn 개체를 제거합니다.
Remove(String)	컬렉션에서 DataColumn 지정된 이름을 포함하는 개체를 제거합니다.

Remove(DataColumn)

컬렉션에서 지정된 DataColumn 개체를 제거합니다.

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

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

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

Public Sub Remove (column As DataColumn)

매개 변수

column

DataColumn

제거할 항목입니다 DataColumn .

예외

ArgumentNullException

매개 변수는 column .입니다 null.

ArgumentException

열이 이 컬렉션에 속하지 않습니다.

-또는-

열은 관계의 일부입니다.

-또는-

다른 열의 식은 이 열에 따라 달라집니다.

예제

다음 예제에서는 메서드를 Contains 사용하여 명명된 열이 있는지 여부를 확인합니다. 이 경우 속성은 Item[] 열을 반환합니다. 그런 다음, 메서드는 CanRemove 열을 제거할 수 있는지 여부를 확인합니다. 이 경우 메서드는 Remove 열을 제거합니다.

private void TestAndRemove(DataColumn colToRemove)
{
    DataColumnCollection columns;
    // Get the DataColumnCollection from a DataTable in a DataSet.
    columns = DataSet1.Tables["Orders"].Columns;

    if(columns.Contains(colToRemove.ColumnName))
    {
        columns.Remove(colToRemove);
    }
}

Private Sub TestAndRemove(ByVal colToRemove As DataColumn)
    ' Get the DataColumnCollection from a DataTable in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns
 
    If columns.Contains(colToRemove.ColumnName) Then
       columns.Remove(colToRemove)
    End If
End Sub

설명

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

추가 정보

• Contains(String)
• CanRemove(DataColumn)
• Item[Int32]

Remove(String)

컬렉션에서 DataColumn 지정된 이름을 포함하는 개체를 제거합니다.

public:
 void Remove(System::String ^ name);

public void Remove(string name);

member this.Remove : string -> unit

Public Sub Remove (name As String)

매개 변수

name

String

제거할 열의 이름입니다.

예외

ArgumentException

컬렉션에 지정된 이름의 열이 없습니다.

예제

다음 예제에서는 먼저 메서드를 Contains 사용하여 컬렉션에서 특정 열을 찾을 수 있는지 여부를 확인합니다. 검색된 경우 메서드는 CanRemove 열을 제거할 수 있는지 여부를 테스트합니다. 이 경우 메서드를 사용하여 열이 Remove 제거됩니다.

private void RemoveColumnByName(string columnName)
{
    // Get the DataColumnCollection from a DataTable in a DataSet.
    DataColumnCollection columns =
        ds.Tables["Suppliers"].Columns;

    if(columns.Contains(columnName))
        if(columns.CanRemove(columns[columnName]))
            columns.Remove(columnName);
}

Private Sub RemoveColumnByName(columnName As String)

    ' Get the DataColumnCollection from a DataTable in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns

    If columns.Contains(columnName) Then 
        If columns.CanRemove(columns(columnName)) Then 
            columns.Remove(columnName)
        End If
    End If
 End Sub

설명

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

추가 정보

• Contains(String)