DataRow 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
DataTable의 데이터 행을 나타냅니다.
public ref class DataRowpublic class DataRow[System.Serializable]
public class DataRowtype DataRow = class[<System.Serializable>]
type DataRow = classPublic Class DataRow- 상속
-
DataRow
- 특성
예제
다음 예제에서는 개체의 DataTable 메서드를 NewRow 호출하여 새 DataRow 를 만듭니다.
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;
}
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 New DataTable("Names")
' Add three column objects to the table.
Dim idColumn As New DataColumn()
idColumn.DataType = System.Type.GetType("System.Int32")
idColumn.ColumnName = "id"
idColumn.AutoIncrement = True
namesTable.Columns.Add(idColumn)
Dim fNameColumn As New DataColumn()
fNameColumn.DataType = System.Type.GetType("System.String")
fNameColumn.ColumnName = "Fname"
fNameColumn.DefaultValue = "Fname"
namesTable.Columns.Add(fNameColumn)
Dim lNameColumn As 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
설명
및 개체는 DataRow 의 기본 구성 요소입니다DataTable.DataColumn DataRow 개체와 해당 속성 및 메서드를 사용하여 를 검색 및 평가하고, 의 DataTable값을 삽입, 삭제 및 업데이트합니다. 는 DataRowCollection 의 실제 DataRow 개체를 DataTable나타내며 DataColumnCollection 에는 의 스키마를 DataColumn 설명하는 개체가 DataTable포함됩니다. 오버로드된 Item[] 속성을 사용하여 의 DataColumn값을 반환하거나 설정합니다.
HasVersion 및 IsNull 속성을 사용하여 특정 행 값 RowState 의 상태를 확인하고 속성을 사용하여 부모 DataTable에 상대적인 행의 상태를 확인합니다.
새 DataRow를 만들려면 개체의 NewRow 메서드를 DataTable 사용합니다. 새 DataRow를 만든 후 메서드를 Add 사용하여 에 새 DataRow 를 추가합니다 DataRowCollection. 마지막으로 개체의 메서드를 AcceptChangesDataTable 호출하여 추가를 확인합니다. 에 데이터를 DataTable추가하는 방법에 대한 자세한 내용은 DataTable에 데이터 추가를 참조하세요.
의 메서드를 DataRow 호출하거나 개체의 메서드를 RemoveDataRowCollection호출하여 에서 DataRowCollection 을 Delete 삭제할 DataRow 수 있습니다. 메서드는 Remove 컬렉션에서 행을 제거합니다. 반면, Delete 는 제거를 위해 을 표시합니다 DataRow . 실제 제거는 메서드를 호출 AcceptChanges 할 때 발생합니다. 를 호출 Delete하면 실제로 삭제하기 전에 제거로 표시된 행을 프로그래밍 방식으로 확인할 수 있습니다. 자세한 내용은 DataRow 삭제를 참조하세요.
생성자
| DataRow(DataRowBuilder) |
지정된 작성기를 사용하여 DataRow 클래스의 새 인스턴스를 초기화합니다. 내부 전용입니다. |
속성
| HasErrors |
행에 오류가 있는지 여부를 나타내는 값을 가져옵니다. |
| Item[DataColumn, DataRowVersion] |
지정된 DataColumn에 저장된 특정 버전의 데이터를 가져옵니다. |
| Item[DataColumn] |
지정된 DataColumn에 저장된 데이터를 가져오거나 설정합니다. |
| Item[Int32, DataRowVersion] |
검색할 데이터의 지정된 버전 및 인덱스를 가진 열에 저장된 데이터를 가져옵니다. |
| Item[Int32] |
지정된 인덱스를 가진 열에 저장된 데이터를 가져오거나 설정합니다. |
| Item[String, DataRowVersion] |
명명된 열에 저장된 특정 버전의 데이터를 가져옵니다. |
| Item[String] |
지정된 이름을 가진 열에 저장된 데이터를 가져오거나 설정합니다. |
| ItemArray |
배열을 통해 이 행의 모든 값을 가져오거나 설정합니다. |
| RowError |
행에 대한 사용자 지정 오류 설명을 가져오거나 설정합니다. |
| RowState |
DataRowCollection과의 관계와 관련하여 행의 현재 상태를 가져옵니다. |
| Table |
이 행에 스키마가 있는 DataTable을 가져옵니다. |
메서드
확장 메서드
적용 대상
스레드 보안
이 형식은 다중 스레드 읽기 작업에 안전합니다. 모든 쓰기 작업을 동기화해야 합니다.
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기