DataRow 클래스

정의

DataTable의 데이터 행을 나타냅니다.Represents a row of data in a DataTable.

public ref class DataRow
public class DataRow
[System.Serializable]
public class DataRow
type DataRow = class
Public Class DataRow
상속
DataRow
특성

예제

다음 예제에서는 DataTable 개체의 NewRow 메서드를 호출 하 여 새 DataRow을 만듭니다.The following example creates a new DataRow by calling the NewRow method of the DataTable object.

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

설명

DataRowDataColumn 개체는 DataTable의 기본 구성 요소입니다.The DataRow and DataColumn objects are primary components of a DataTable. DataRow 개체와 해당 속성 및 메서드를 사용 하 여 검색 하 고 평가 합니다. 및 DataTable의 값을 삽입, 삭제 및 업데이트 합니다.Use the DataRow object and its properties and methods to retrieve and evaluate; and insert, delete, and update the values in the DataTable. DataRowCollectionDataTable의 실제 DataRow 개체를 나타내며 DataColumnCollection에는 DataColumn의 스키마를 설명 하는 DataTable개체가 포함 되어 있습니다.The DataRowCollection represents the actual DataRow objects in the DataTable, and the DataColumnCollection contains the DataColumn objects that describe the schema of the DataTable. 오버 로드 된 Item[] 속성을 사용 하 여 DataColumn값을 반환 하거나 설정 합니다.Use the overloaded Item[] property to return or set the value of a DataColumn.

HasVersionIsNull 속성을 사용 하 여 특정 행 값의 상태를 확인 하 고 RowState 속성을 사용 하 여 부모 DataTable를 기준으로 행의 상태를 확인 합니다.Use the HasVersion and IsNull properties to determine the status of a particular row value, and the RowState property to determine the state of the row relative to its parent DataTable.

DataRow을 만들려면 DataTable 개체의 NewRow 메서드를 사용 합니다.To create a new DataRow, use the NewRow method of the DataTable object. DataRow을 만든 후 Add 메서드를 사용 하 여 DataRowCollection에 새 DataRow를 추가 합니다.After creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. 마지막으로 DataTable 개체의 AcceptChanges 메서드를 호출 하 여 더하기를 확인 합니다.Finally, call the AcceptChanges method of the DataTable object to confirm the addition. DataTable에 데이터를 추가 하는 방법에 대 한 자세한 내용은 DataTable에 데이터 추가를 참조 하세요.For more information about adding data to a DataTable, see Adding Data to a DataTable.

DataRowCollectionRemove 메서드를 호출 하거나 Delete 개체의 DataRow 메서드를 호출 하 여 DataRowCollection에서 DataRow를 삭제할 수 있습니다.You can delete a DataRow from the DataRowCollection by calling the Remove method of the DataRowCollection, or by calling the Delete method of the DataRow object. Remove 메서드는 컬렉션에서 행을 제거 합니다.The Remove method removes the row from the collection. 반면 DeleteDataRow 제거를 표시 합니다.In contrast, Delete marks the DataRow for removal. 실제 제거는 AcceptChanges 메서드를 호출할 때 발생 합니다.The actual removal occurs when you call AcceptChanges method. Delete를 호출 하 여 실제로 삭제 하기 전에 제거 하도록 표시 된 행을 프로그래밍 방식으로 확인할 수 있습니다.By calling Delete, you can programmatically check which rows are marked for removal before actually deleting them. 자세한 내용은 DataRow 삭제를 참조 하세요.For more information, see DataRow Deletion.

생성자

DataRow(DataRowBuilder)

DataRow의 새 인스턴스를 초기화합니다.Initializes a new instance of the DataRow. 작성기에서 행을 생성합니다.Constructs a row from the builder. 내부 전용입니다.Only for internal usage.

속성

HasErrors

행에 오류가 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether there are errors in a row.

Item[DataColumn, DataRowVersion]

지정된 DataColumn에 저장된 특정 버전의 데이터를 가져옵니다.Gets the specified version of data stored in the specified DataColumn.

Item[DataColumn]

지정된 DataColumn에 저장된 데이터를 가져오거나 설정합니다.Gets or sets the data stored in the specified DataColumn.

Item[Int32, DataRowVersion]

검색할 데이터의 버전 및 인덱스에서 지정한 열에 저장 된 데이터를 가져옵니다.Gets the data stored in the column, specified by index and version of the data to retrieve.

Item[Int32]

인덱스로 지정 된 열에 저장 된 데이터를 가져오거나 설정 합니다.Gets or sets the data stored in the column specified by index.

Item[String, DataRowVersion]

명명된 된 열에 저장 된 데이터의 지정된 된 버전을 가져옵니다.Gets the specified version of data stored in the named column.

Item[String]

이름별로 지정 된 열에 저장 된 데이터를 가져오거나 설정 합니다.Gets or sets the data stored in the column specified by name.

ItemArray

배열을 통해이 행에 대 한 모든 값을 가져오거나 설정 합니다.Gets or sets all the values for this row through an array.

RowError

행에 대 한 사용자 지정 오류 설명을 가져오거나 설정 합니다.Gets or sets the custom error description for a row.

RowState

DataRowCollection과의 관계와 관련하여 행의 현재 상태를 가져옵니다.Gets the current state of the row with regard to its relationship to the DataRowCollection.

Table

이 행에 스키마가 있는 DataTable을 가져옵니다.Gets the DataTable for which this row has a schema.

메서드

AcceptChanges()

AcceptChanges()가 마지막으로 호출된 이후 이 행에서 변경된 내용을 모두 커밋합니다.Commits all the changes made to this row since the last time AcceptChanges() was called.

BeginEdit()

DataRow 개체에 대한 편집 작업을 시작합니다.Starts an edit operation on a DataRow object.

CancelEdit()

행의 현재 편집을 취소합니다.Cancels the current edit on the row.

ClearErrors()

행에 대 한 오류를 지웁니다.Clears the errors for the row. 여기에는 RowErrorSetColumnError(Int32, String)와 함께 설정된 오류가 포함됩니다.This includes the RowError and errors set with SetColumnError(Int32, String).

Delete()

DataRow를 삭제합니다.Deletes the DataRow.

EndEdit()

행에서 발생 하는 편집을 끝냅니다.Ends the edit occurring on the row.

Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetChildRows(DataRelation)

지정된 DataRow을 사용하여 이 DataRelation의 자식 행을 가져옵니다.Gets the child rows of this DataRow using the specified DataRelation.

GetChildRows(DataRelation, DataRowVersion)

지정된 DataRowDataRelation을 사용하여 DataRowVersion의 자식 행을 가져옵니다.Gets the child rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetChildRows(String)

DataRow의 지정된 RelationName을 사용하여 DataRelation의 자식 행을 가져옵니다.Gets the child rows of a DataRow using the specified RelationName of a DataRelation.

GetChildRows(String, DataRowVersion)

DataRow의 지정된 RelationNameDataRelation을 사용하여 DataRowVersion의 자식 행을 가져옵니다.Gets the child rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetColumnError(DataColumn)

지정된 DataColumn의 오류 설명을 가져옵니다.Gets the error description of the specified DataColumn.

GetColumnError(Int32)

인덱스로 지정 된 열의 오류 설명을 가져옵니다.Gets the error description for the column specified by index.

GetColumnError(String)

이름별로 지정 된 열에 대 한 오류 설명을 가져옵니다.Gets the error description for a column, specified by name.

GetColumnsInError()

오류가 있는 열의 배열을 가져옵니다.Gets an array of columns that have errors.

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetParentRow(DataRelation)

지정된 DataRow을 사용하여 DataRelation의 부모 행을 가져옵니다.Gets the parent row of a DataRow using the specified DataRelation.

GetParentRow(DataRelation, DataRowVersion)

지정된 DataRowDataRelation을 사용하여 DataRowVersion의 부모 행을 가져옵니다.Gets the parent row of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRow(String)

DataRow의 지정된 RelationName을 사용하여 DataRelation의 부모 행을 가져옵니다.Gets the parent row of a DataRow using the specified RelationName of a DataRelation.

GetParentRow(String, DataRowVersion)

DataRow의 지정된 RelationNameDataRelation을 사용하여 DataRowVersion의 부모 행을 가져옵니다.Gets the parent row of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetParentRows(DataRelation)

지정된 DataRow을 사용하여 DataRelation의 부모 행을 가져옵니다.Gets the parent rows of a DataRow using the specified DataRelation.

GetParentRows(DataRelation, DataRowVersion)

지정된 DataRowDataRelation을 사용하여 DataRowVersion의 부모 행을 가져옵니다.Gets the parent rows of a DataRow using the specified DataRelation, and DataRowVersion.

GetParentRows(String)

DataRow의 지정된 RelationName을 사용하여 DataRelation의 부모 행을 가져옵니다.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation.

GetParentRows(String, DataRowVersion)

DataRow의 지정된 RelationNameDataRelation을 사용하여 DataRowVersion의 부모 행을 가져옵니다.Gets the parent rows of a DataRow using the specified RelationName of a DataRelation, and DataRowVersion.

GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
HasVersion(DataRowVersion)

지정된 된 버전이 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether a specified version exists.

IsNull(DataColumn)

지정된 DataColumn에 null 값이 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the specified DataColumn contains a null value.

IsNull(DataColumn, DataRowVersion)

지정된 DataColumnDataRowVersion에 null 값이 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the specified DataColumn and DataRowVersion contains a null value.

IsNull(Int32)

지정된 된 인덱스에 열을 null 값이 들어 있는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the column at the specified index contains a null value.

IsNull(String)

명명된 된 열에 null 값 포함 되는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the named column contains a null value.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
RejectChanges()

AcceptChanges()를 마지막으로 호출한 이후에 수행된 행의 모든 변경 내용을 취소합니다.Rejects all changes made to the row since AcceptChanges() was last called.

SetAdded()

RowStateDataRowAdded로 변경합니다.Changes the RowState of a DataRow to Added.

SetColumnError(DataColumn, String)

DataColumn으로 지정된 열에 대한 오류 설명을 설정합니다.Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String)

인덱스로 지정 된 열에 대 한 오류 설명을 설정 합니다.Sets the error description for a column specified by index.

SetColumnError(String, String)

이름별로 지정 된 열에 대 한 오류 설명을 설정 합니다.Sets the error description for a column specified by name.

SetModified()

RowStateDataRowModified로 변경합니다.Changes the RowState of a DataRow to Modified.

SetNull(DataColumn)

지정된 DataColumn의 값을 null 값으로 설정합니다.Sets the value of the specified DataColumn to a null value.

SetParentRow(DataRow)

지정된 새 부모 DataRow를 가지는 DataRow의 부모 행을 설정합니다.Sets the parent row of a DataRow with specified new parent DataRow.

SetParentRow(DataRow, DataRelation)

지정된 새 부모 DataRowDataRow을 가지는 DataRelation의 부모 행을 설정합니다.Sets the parent row of a DataRow with specified new parent DataRow and DataRelation.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

확장 메서드

Field<T>(DataRow, DataColumn)

각 열 값에 지정된 된 행에 대 한 강력한 형식의 액세스를 제공합니다.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn) 메서드는 nullable 형식도 지원합니다.The Field<T>(DataRow, DataColumn) method also supports nullable types.

Field<T>(DataRow, DataColumn, DataRowVersion)

각 열 값에 지정된 된 행에 대 한 강력한 형식의 액세스를 제공합니다.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn, DataRowVersion) 메서드는 nullable 형식도 지원합니다.The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, Int32)

각 열 값에 지정된 된 행에 대 한 강력한 형식의 액세스를 제공합니다.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32) 메서드는 nullable 형식도 지원합니다.The Field<T>(DataRow, Int32) method also supports nullable types.

Field<T>(DataRow, Int32, DataRowVersion)

각 열 값에 지정된 된 행에 대 한 강력한 형식의 액세스를 제공합니다.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32, DataRowVersion) 메서드는 nullable 형식도 지원합니다.The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, String)

각 열 값에 지정된 된 행에 대 한 강력한 형식의 액세스를 제공합니다.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String) 메서드는 nullable 형식도 지원합니다.The Field<T>(DataRow, String) method also supports nullable types.

Field<T>(DataRow, String, DataRowVersion)

각 열 값에 지정된 된 행에 대 한 강력한 형식의 액세스를 제공합니다.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String, DataRowVersion) 메서드는 nullable 형식도 지원합니다.The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

SetField<T>(DataRow, DataColumn, T)

DataRow에서 지정된 열의 새 값을 설정합니다.Sets a new value for the specified column in the DataRow. SetField<T>(DataRow, DataColumn, T) 메서드는 nullable 형식도 지원합니다.The SetField<T>(DataRow, DataColumn, T) method also supports nullable types.

SetField<T>(DataRow, Int32, T)

메서드가 호출된 DataRow에서 지정된 열의 새 값을 설정합니다.Sets a new value for the specified column in the DataRow the method is called on. SetField<T>(DataRow, Int32, T) 메서드는 nullable 형식도 지원합니다.The SetField<T>(DataRow, Int32, T) method also supports nullable types.

SetField<T>(DataRow, String, T)

DataRow에서 지정된 열의 새 값을 설정합니다.Sets a new value for the specified column in the DataRow. SetField<T>(DataRow, String, T) 메서드는 nullable 형식도 지원합니다.The SetField<T>(DataRow, String, T) method also supports nullable types.

적용 대상

스레드 보안

이 유형은 다중 스레드 읽기 작업에 안전 합니다.This type is safe for multithreaded read operations. 모든 쓰기 작업을 동기화 해야 합니다.You must synchronize any write operations.

추가 정보