DataRow DataRow DataRow DataRow Class

정의

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

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

예제

다음 예제에서는 새 DataRow 를 호출 하 여 합니다 NewRow 메서드를 DataTable 개체입니다.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 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

설명

합니다 DataRow 하 고 DataColumn 개체의 기본 구성 요소는는 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. DataRowCollection 실제 나타냅니다 DataRow 개체를 DataTable, 및 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[String, DataRowVersion] 반환 값을 설정 하는 속성을 DataColumn입니다.Use the overloaded Item[String, DataRowVersion] property to return or set the value of a DataColumn.

사용 하 여는 HasVersion 하 고 IsNull 특정 행 값의 상태를 확인 하는 속성 및 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를 사용 합니다 NewRow 메서드의 DataTable 개체입니다.To create a new DataRow, use the NewRow method of the DataTable object. 새로 만든 후 DataRow를 사용 하 여는 Add 새을 추가 하는 방법 DataRowDataRowCollection합니다.After creating a new DataRow, use the Add method to add the new DataRow to the DataRowCollection. 마지막으로 호출 합니다 AcceptChanges 메서드는 DataTable 추가 확인 하는 개체입니다.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.

삭제할 수 있습니다는 DataRow 에서 DataRowCollection 호출 하 여를 Remove 메서드의 DataRowCollection, 또는 호출 하 여는 Delete 메서드의 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. 반대로 Delete 표시는 DataRow 제거 합니다.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(DataRowBuilder) DataRow(DataRowBuilder) DataRow(DataRowBuilder)

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

속성

HasErrors HasErrors HasErrors HasErrors

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

ItemArray ItemArray ItemArray ItemArray

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

Item[DataColumn, DataRowVersion] Item[DataColumn, DataRowVersion] Item[DataColumn, DataRowVersion] Item[DataColumn, DataRowVersion]

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

Item[DataColumn] Item[DataColumn] Item[DataColumn] Item[DataColumn]

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

Item[Int32, DataRowVersion] Item[Int32, DataRowVersion] Item[Int32, DataRowVersion] Item[Int32, DataRowVersion]

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

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

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

Item[String, DataRowVersion] Item[String, DataRowVersion] Item[String, DataRowVersion] Item[String, DataRowVersion]

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

Item[String] Item[String] Item[String] Item[String]

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

RowError RowError RowError RowError

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

RowState RowState RowState RowState

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

Table Table Table Table

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

메서드

AcceptChanges() AcceptChanges() AcceptChanges() AcceptChanges()

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

BeginEdit() BeginEdit() BeginEdit() BeginEdit()

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

CancelEdit() CancelEdit() CancelEdit() CancelEdit()

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

ClearErrors() ClearErrors() ClearErrors() ClearErrors()

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

Delete() Delete() Delete() Delete()

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

EndEdit() EndEdit() EndEdit() EndEdit()

행에서 수행 중인 편집을 끝냅니다.Ends the edit occurring on the row.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation) GetChildRows(DataRelation)

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

GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion) GetChildRows(DataRelation, DataRowVersion)

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

GetChildRows(String) GetChildRows(String) GetChildRows(String) GetChildRows(String)

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

GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion) GetChildRows(String, DataRowVersion)

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

GetColumnError(DataColumn) GetColumnError(DataColumn) GetColumnError(DataColumn) GetColumnError(DataColumn)

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

GetColumnError(Int32) GetColumnError(Int32) GetColumnError(Int32) GetColumnError(Int32)

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

GetColumnError(String) GetColumnError(String) GetColumnError(String) GetColumnError(String)

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

GetColumnsInError() GetColumnsInError() GetColumnsInError() GetColumnsInError()

오류가 있는 열로 이루어진 배열을 가져옵니다.Gets an array of columns that have errors.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetParentRow(DataRelation) GetParentRow(DataRelation) GetParentRow(DataRelation) GetParentRow(DataRelation)

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

GetParentRow(DataRelation, DataRowVersion) GetParentRow(DataRelation, DataRowVersion) GetParentRow(DataRelation, DataRowVersion) GetParentRow(DataRelation, DataRowVersion)

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

GetParentRow(String) GetParentRow(String) GetParentRow(String) GetParentRow(String)

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

GetParentRow(String, DataRowVersion) GetParentRow(String, DataRowVersion) GetParentRow(String, DataRowVersion) GetParentRow(String, DataRowVersion)

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

GetParentRows(DataRelation) GetParentRows(DataRelation) GetParentRows(DataRelation) GetParentRows(DataRelation)

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

GetParentRows(DataRelation, DataRowVersion) GetParentRows(DataRelation, DataRowVersion) GetParentRows(DataRelation, DataRowVersion) GetParentRows(DataRelation, DataRowVersion)

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

GetParentRows(String) GetParentRows(String) GetParentRows(String) GetParentRows(String)

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

GetParentRows(String, DataRowVersion) GetParentRows(String, DataRowVersion) GetParentRows(String, DataRowVersion) GetParentRows(String, DataRowVersion)

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

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
HasVersion(DataRowVersion) HasVersion(DataRowVersion) HasVersion(DataRowVersion) HasVersion(DataRowVersion)

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

IsNull(DataColumn) IsNull(DataColumn) IsNull(DataColumn) IsNull(DataColumn)

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

IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion) IsNull(DataColumn, DataRowVersion)

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

IsNull(Int32) IsNull(Int32) IsNull(Int32) IsNull(Int32)

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

IsNull(String) IsNull(String) IsNull(String) IsNull(String)

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

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
RejectChanges() RejectChanges() RejectChanges() RejectChanges()

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

SetAdded() SetAdded() SetAdded() SetAdded()

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

SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) SetColumnError(DataColumn, String)

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

SetColumnError(Int32, String) SetColumnError(Int32, String) SetColumnError(Int32, String) SetColumnError(Int32, String)

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

SetColumnError(String, String) SetColumnError(String, String) SetColumnError(String, String) SetColumnError(String, String)

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

SetModified() SetModified() SetModified() SetModified()

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

SetNull(DataColumn) SetNull(DataColumn) SetNull(DataColumn) SetNull(DataColumn)

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

SetParentRow(DataRow) SetParentRow(DataRow) SetParentRow(DataRow) SetParentRow(DataRow)

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

SetParentRow(DataRow, DataRelation) SetParentRow(DataRow, DataRelation) SetParentRow(DataRow, DataRelation) SetParentRow(DataRow, DataRelation)

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

ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Extension Methods

Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn) 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) Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion) 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) Field<T>(DataRow, Int32) Field<T>(DataRow, Int32) 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) Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion) 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) Field<T>(DataRow, String) Field<T>(DataRow, String) 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) Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion) 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) SetField<T>(DataRow, DataColumn, T) SetField<T>(DataRow, DataColumn, T) 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) SetField<T>(DataRow, Int32, T) SetField<T>(DataRow, Int32, T) 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) SetField<T>(DataRow, String, T) SetField<T>(DataRow, String, T) 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.

추가 정보