DataRow 클래스

아티클
08/21/2007

DataTable의 데이터 행을 나타냅니다.

네임스페이스: System.Data
어셈블리: System.Data(system.data.dll)

구문

‘선언
Public Class DataRow
‘사용 방법
Dim instance As DataRow

public class DataRow

public ref class DataRow

public class DataRow

public class DataRow

설명

DataRow 개체와 DataColumn 개체는 DataTable의 기본 구성 요소입니다. DataRow 개체 및 해당 속성과 메서드를 사용하여 DataTable의 값을 검색, 계산, 삽입, 삭제 및 업데이트합니다. DataRowCollection은 DataTable에 있는 실제 DataRow 개체를 나타내고 DataColumnCollection은 DataTable의 스키마를 설명하는 DataColumn 개체를 포함합니다. 오버로드된 Item 속성을 사용하여 DataColumn의 값을 반환하거나 설정합니다.

HasVersion 속성과 IsNull 속성을 사용하여 특정 행 값의 상태를 결정하고, RowState 속성을 사용하여 부모 DataTable과 관련된 행의 상태를 결정합니다.

새 DataRow를 만들려면 DataTable 개체의 NewRow 메서드를 사용합니다. 새 DataRow를 만든 후 Add 메서드를 사용하여 DataRowCollection에 새 DataRow를 추가합니다. 마지막으로 DataTable 개체의 AcceptChanges 메서드를 호출하여 추가를 확인합니다. DataTable에 데이터를 추가하는 방법에 대한 자세한 내용은 테이블에 데이터 추가을 참조하십시오.

DataRowCollection의 Remove 메서드를 호출하거나 DataRow 개체의 Delete 메서드를 호출하여 DataRowCollection에서 DataRow를 삭제할 수 있습니다. Remove 메서드는 컬렉션에서 행을 제거합니다. 이에 비해 Delete는 DataRow에 제거 표시를 합니다. 표시된 행은 AcceptChanges 메서드를 호출할 때 제거됩니다. 행을 실제로 삭제하기 전에 Delete를 호출하여 제거 표시된 행을 프로그래밍 방식으로 확인할 수 있습니다. 자세한 내용은 테이블에서 행 삭제를 참조하십시오.

예제

다음 예제에서는 DataTable 개체의 NewRow 메서드를 호출하여 새 DataRow를 만듭니다.

Private Sub CreateNewDataRow()
    ' Use the MakeTable function below to create a new table.
    Dim table As DataTable
    table = MakeNamesTable()

    ' Once a table has been created, use the 
    ' NewRow to create a DataRow.
    Dim row As DataRow 
    row = table.NewRow()

    ' Then add the new row to the collection.
    row("fName") = "John"
    row("lName") = "Smith"
    table.Rows.Add(row)
    
    Dim column As DataColumn
    For Each column in table.Columns
       Console.WriteLine(column.ColumnName)
    Next
    DataGrid1.DataSource=table
 End Sub
 
 Private Function MakeNamesTable() As DataTable
    ' Create a new DataTable titled 'Names.'
    Dim namesTable As DataTable = new DataTable("Names") 

    ' Add three column objects to the table.
    Dim idColumn As DataColumn = new  DataColumn()
    idColumn.DataType = System.Type.GetType("System.Int32")
    idColumn.ColumnName = "id"
    idColumn.AutoIncrement = True
    namesTable.Columns.Add(idColumn)

    Dim fNameColumn As DataColumn = New DataColumn()
    fNameColumn.DataType = System.Type.GetType("System.String")
    fNameColumn.ColumnName = "Fname"
    fNameColumn.DefaultValue = "Fname"
    namesTable.Columns.Add(fNameColumn)

    Dim lNameColumn As DataColumn = new DataColumn()
    lNameColumn.DataType = System.Type.GetType("System.String")
    lNameColumn.ColumnName = "LName"
    namesTable.Columns.Add(lNameColumn)

    ' Create an array for DataColumn objects.
    Dim keys(0) As DataColumn 
    keys(0) = idColumn
    namesTable.PrimaryKey = keys

    ' Return the new DataTable.
    MakeNamesTable = namesTable
 End Function

private void CreateNewDataRow()
{
    // Use the MakeTable function below to create a new table.
    DataTable table;
    table = MakeNamesTable();

    // Once a table has been created, use the 
    // NewRow to create a DataRow.
    DataRow row;
    row = table.NewRow();

    // Then add the new row to the collection.
    row["fName"] = "John";
    row["lName"] = "Smith";
    table.Rows.Add(row);

    foreach(DataColumn column in table.Columns)
        Console.WriteLine(column.ColumnName);
    dataGrid1.DataSource=table;
}
 
private DataTable MakeNamesTable()
{
    // Create a new DataTable titled 'Names.'
    DataTable namesTable = new DataTable("Names"); 

    // Add three column objects to the table.
    DataColumn idColumn = new  DataColumn();
    idColumn.DataType = System.Type.GetType("System.Int32");
    idColumn.ColumnName = "id";
    idColumn.AutoIncrement = true;
    namesTable.Columns.Add(idColumn);

    DataColumn fNameColumn = new DataColumn();
    fNameColumn.DataType = System.Type.GetType("System.String");
    fNameColumn.ColumnName = "Fname";
    fNameColumn.DefaultValue = "Fname";
    namesTable.Columns.Add(fNameColumn);

    DataColumn lNameColumn = new DataColumn();
    lNameColumn.DataType = System.Type.GetType("System.String");
    lNameColumn.ColumnName = "LName";
    namesTable.Columns.Add(lNameColumn);

    // Create an array for DataColumn objects.
    DataColumn [] keys = new DataColumn [1];
    keys[0] = idColumn;
    namesTable.PrimaryKey = keys;

    // Return the new DataTable.
    return namesTable;
}

상속 계층 구조

System.Object
System.Data.DataRow

스레드로부터의 안전성

이 형식은 다중 스레드 읽기 작업에 안전합니다. 쓰기 작업을 동기화해야 합니다.

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

DataRow 멤버
System.Data 네임스페이스
AcceptChanges
Add
DataColumnCollection 클래스
DataColumn 클래스
DataRowView
DataTable
HasVersion
IsNull
Item
NewRow
DataRowCollection

다음을 통해 공유