DataRowCollection.Add 메서드

정의

DataRowDataRowCollection를 추가합니다.Adds a DataRow to the DataRowCollection.

오버로드

Add(DataRow)

지정된 DataRowDataRowCollection 개체에 추가합니다.Adds the specified DataRow to the DataRowCollection object.

Add(Object[])

지정한 값을 사용하여 행을 만들고 그 행을 DataRowCollection에 추가합니다.Creates a row using specified values and adds it to the DataRowCollection.

Add(DataRow)

지정된 DataRowDataRowCollection 개체에 추가합니다.Adds the specified DataRow to the DataRowCollection object.

public:
 void Add(System::Data::DataRow ^ row);
public void Add (System.Data.DataRow row);
member this.Add : System.Data.DataRow -> unit
Public Sub Add (row As DataRow)

매개 변수

row
DataRow

추가할 DataRow입니다.The DataRow to add.

예외

행이 null인 경우The row is null.

이 행이 다른 테이블에 속하거나 이 테이블에 이미 속해 있는 경우The row either belongs to another table or already belongs to this table.

추가로 인해 제약 조건이 무효화되는경우The addition invalidates a constraint.

추가하는 동안 DataColumn이 false인 AllowDBNull에 null을 삽입하려고 하는 경우The addition tries to put a null in a DataColumn where AllowDBNull is false.

예제

다음 예제에서는 합니다 Add 새로 추가 하는 방법 DataRowDataRowCollection 개체.The following example uses the Add method to add a new DataRow to a DataRowCollection object.

   private void ShowRows(DataTable table)
   {
       // Print the number of rows in the collection.
       Console.WriteLine(table.Rows.Count);
       // Print the value of columns 1 in each row
       foreach(DataRow row in table.Rows)
       {
           Console.WriteLine(row[1]);
       }
   }

   private void AddRow(DataTable table)
   {
       DataRowCollection rowCollection = table.Rows;
       // Instantiate a new row using the NewRow method.

       DataRow newRow = table.NewRow();
       // Insert code to fill the row with values.

       // Add the row to the DataRowCollection.
       table.Rows.Add(newRow);
   }
Private Sub ShowRows(Byval table As DataTable)
    ' Print the number of rows in the collection.
    Console.WriteLine(table.Rows.Count)

    Dim row  As DataRow
    ' Print the value of columns 1 in each row
    For Each row In table.Rows
        Console.WriteLine(row(1))
    Next
End Sub
 
Private Sub AddRow(ByVal table As DataTable)
    ' Instantiate a new row using the NewRow method.
    Dim newRow As DataRow = table.NewRow()
    ' Insert code to fill the row with values.

    ' Add the row to the DataRowCollection.
    table.Rows.Add(newRow)
End Sub

설명

DataRow를 사용 해야 합니다는 NewRow 메서드를 DataTable 클래스입니다.To create a new DataRow, you must use the NewRow method of the DataTable class. 사용 하는 경우는 NewRow 메서드를 새 DataRow 개체의 부모 스키마를 사용 하 여 반환 됩니다 DataTable합니다.When you use the NewRow method, a new DataRow object is returned using the schema of parent DataTable. 만든 후 합니다 DataRow 개체의 각 열에 대 한 값을 설정 하 고 사용 하 여는 Add 개체 컬렉션에 추가 하는 방법입니다.After you create the DataRow object and set the values for each of its columns, use the Add method to add the object to the collection.

사용자의 예외를 생성 하는 경우 예외를 생성 합니다 RowChanging 이벤트입니다.Generates an exception if the user generates an exception in the RowChanging event. 예외가 발생 하는 경우 테이블에 행 추가 되지 않습니다.If an exception occurs, the row is not added to the table.

추가 정보

Add(Object[])

지정한 값을 사용하여 행을 만들고 그 행을 DataRowCollection에 추가합니다.Creates a row using specified values and adds it to the DataRowCollection.

public:
 virtual System::Data::DataRow ^ Add(cli::array <System::Object ^> ^ values);
public virtual System.Data.DataRow Add (object[] values);
abstract member Add : obj[] -> System.Data.DataRow
override this.Add : obj[] -> System.Data.DataRow
Public Overridable Function Add (values As Object()) As DataRow

매개 변수

values
Object[]

새 행을 만드는데 사용하는 값 배열입니다.The array of values that are used to create the new row.

반환

없음None.

예외

배열이 테이블의 열 수보다 큰 경우The array is larger than the number of columns in the table.

값이 해당 열 형식과 일치하지 않는 경우A value does not match its respective column type.

행을 추가하여 제약 조건을 무효화한 경우Adding the row invalidates a constraint.

AllowDBNull이 false인 열에 null을 설정하려고 한 경우Trying to put a null in a column where AllowDBNull is false.

예제

다음 예제에서는 합니다 Add 메서드를 만들고 새 DataRow 개체를 DataRowCollection합니다.The following example uses the Add method to create and add a new DataRow object to a DataRowCollection.

private void AddRow(DataTable table)
{
    // Create an array with three elements.
    object[] rowVals = new object[3];
    DataRowCollection rowCollection = table.Rows;
    rowVals[0] = "hello";
    rowVals[1] = "world";
    rowVals[2] = "two";

    // Add and return the new row.
    DataRow row = rowCollection.Add(rowVals);
}
Private Sub AddRow(ByVal table As DataTable)
    ' Create an array with three elements.
    Dim rowVals(2) As Object
    Dim rowCollection As DataRowCollection = table.Rows
    rowVals(0) = "hello"
    rowVals(1) = "world"
    rowVals(2) = "two"

    ' Add and return the new row.
    Dim row As DataRow = rowCollection.Add(rowVals) 
End Sub

설명

경우는 DataColumn 개체에 해당 AutoIncrement True로 설정 된 null이 전달 되어야 해당 열에 대 한 기본 값을 가져오려고 합니다.If a DataColumn object has its AutoIncrement set to True, null should be passed to get the default value for that column.

예외는 수행 하는 동안 예외가 발생 하는 경우에 발생할 수 있습니다는 ColumnChanging 또는 RowChanging 이벤트입니다.Exceptions can also occur if you generate an exception during either a ColumnChanging or RowChanging event. 예외가 발생 하는 경우 테이블에 행 추가 되지 않습니다.If an exception occurs, the row is not added to the table.

추가 정보

적용 대상