DataColumnCollection.Remove 메서드

정의

네임스페이스:

System.Data

어셈블리:

System.Data.Common.dll

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

오버로드

Remove(DataColumn)	컬렉션에서 지정된 DataColumn 개체를 제거합니다.
Remove(String)	컬렉션에서 지정된 이름의 DataColumn 개체를 제거합니다.

Remove(DataColumn)

Source:

DataColumnCollection.cs

컬렉션에서 지정된 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)

Source:

DataColumnCollection.cs

컬렉션에서 지정된 이름의 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)