DataTable.LoadDataRow 메서드

정의

네임스페이스:

System.Data

어셈블리:

System.Data.Common.dll

특정 행을 찾아 업데이트합니다. 일치하는 행을 찾지 못하면 지정된 값을 사용하여 새 행을 만듭니다.

오버로드

LoadDataRow(Object[], Boolean)	특정 행을 찾아 업데이트합니다. 일치하는 행을 찾지 못하면 지정된 값을 사용하여 새 행을 만듭니다.
LoadDataRow(Object[], LoadOption)	특정 행을 찾아 업데이트합니다. 일치하는 행을 찾지 못하면 지정된 값을 사용하여 새 행을 만듭니다.

LoadDataRow(Object[], Boolean)

Source:

DataTable.cs

특정 행을 찾아 업데이트합니다. 일치하는 행을 찾지 못하면 지정된 값을 사용하여 새 행을 만듭니다.

public:
 System::Data::DataRow ^ LoadDataRow(cli::array <System::Object ^> ^ values, bool fAcceptChanges);

public System.Data.DataRow LoadDataRow (object?[] values, bool fAcceptChanges);

member this.LoadDataRow : obj[] * bool -> System.Data.DataRow

Public Function LoadDataRow (values As Object(), fAcceptChanges As Boolean) As DataRow

매개 변수

values

Object[]

새 행을 만드는 데 사용되는 값 배열입니다.

fAcceptChanges

Boolean

변경 사항을 적용하려면 true이고, 그렇지 않으면 false입니다.

반환

DataRow

새 DataRow입니다.

예외

ArgumentException

배열이 테이블의 열 수보다 큰 경우

InvalidCastException

값이 해당 열 형식과 일치하지 않는 경우

ConstraintException

행을 추가하여 제약 조건을 무효화한 경우

NoNullAllowedException

AllowDBNull이 false인 열에 null을 설정하려는 경우

예제

다음 예제에서는 메서드를 LoadDataRow 사용하여 행을 찾으려고 시도합니다. 이러한 행을 찾을 수 없는 경우 값은 새 행을 만드는 데 사용됩니다.

using System;
using System.Data;

class MyDataSet {
   public static void Main() {
      DataTable dt = new DataTable();

      DataColumn dc1 = new DataColumn("col1");
      DataColumn dc2 = new DataColumn("col2");
      DataColumn dc3 = new DataColumn("col3");

      dt.Columns.Add(dc1);
      dt.Columns.Add(dc2);
      dt.Columns.Add(dc3);

      // Create an array for the values.
      object[] newRow = new object[3];

      // Set the values of the array.
      newRow[0] = "Hello";
      newRow[1] = "World";
      newRow[2] = "two";
      DataRow row;

      dt.BeginLoadData();

      // Add the new row to the rows collection.
      row = dt.LoadDataRow(newRow, true);

      foreach (DataRow dr in dt.Rows) {
         Console.WriteLine(String.Format("Row: {0}, {1}, {2}", dr["col1"], dr["col2"], dr["col3"]));
      }

      dt.EndLoadData();
   }
}

Imports System.Data

Class MyDataSet
   Public Shared Sub Main()
      Dim dt As New DataTable()

      Dim dc1 As New DataColumn("col1")
      Dim dc2 As New DataColumn("col2")
      Dim dc3 As New DataColumn("col3")

      dt.Columns.Add(dc1)
      dt.Columns.Add(dc2)
      dt.Columns.Add(dc3)

      ' Create an array for the values.
      Dim newRow As Object() = New Object(2) {}

      ' Set the values of the array.
      newRow(0) = "Hello"
      newRow(1) = "World"
      newRow(2) = "two"
      Dim row As DataRow

      dt.BeginLoadData()

      ' Add the new row to the rows collection.
      row = dt.LoadDataRow(newRow, True)

      For Each dr As DataRow In dt.Rows
         Console.WriteLine([String].Format("Row: {0}, {1}, {2}", dr("col1"), dr("col2"), dr("col3")))
      Next

      dt.EndLoadData()
   End Sub
End Class

설명

메서드는 LoadDataRow 값 배열을 사용하고 기본 키 열에서 일치하는 값을 찾습니다.

열에 기본값이 있는 경우 배열에 null 값을 전달하여 해당 열의 기본값을 설정합니다. 마찬가지로 열에 해당 AutoIncrement 속성이 true로 설정된 경우 배열에 null 값을 전달하여 행에 대해 자동으로 생성된 값을 설정합니다.

매개 변수가 fAcceptChangestrue 지정되었거나 지정되지 않은 경우 새 데이터가 추가된 다음 AcceptChanges 이 호출되어 의 DataTable모든 변경 내용을 수락합니다. 인수가 false이면 새로 추가된 행이 삽입으로 표시되고 기존 행에 대한 변경 내용이 수정으로 표시됩니다.

또는 RowChanging 이벤트 중에 예외가 ColumnChanging 발생할 수도 있습니다. 예외가 발생하면 행이 테이블에 추가되지 않습니다.

및 EndLoadData와 함께 BeginLoadData 를 사용합니다LoadDataRow.

추가 정보

• DataTables
• DataTable 이벤트 처리

LoadDataRow(Object[], LoadOption)

Source:

DataTable.cs

특정 행을 찾아 업데이트합니다. 일치하는 행을 찾지 못하면 지정된 값을 사용하여 새 행을 만듭니다.

public:
 System::Data::DataRow ^ LoadDataRow(cli::array <System::Object ^> ^ values, System::Data::LoadOption loadOption);

public System.Data.DataRow LoadDataRow (object?[] values, System.Data.LoadOption loadOption);

member this.LoadDataRow : obj[] * System.Data.LoadOption -> System.Data.DataRow

Public Function LoadDataRow (values As Object(), loadOption As LoadOption) As DataRow

매개 변수

values

Object[]

새 행을 만드는 데 사용되는 값 배열입니다.

loadOption

LoadOption

배열 값이 기존 행의 해당 값에 적용되는 방식을 결정하는 데 사용됩니다.

반환

DataRow

새 DataRow입니다.

설명

메서드는 LoadDataRow 값 배열을 사용하고 기본 키 열에서 일치하는 값을 찾습니다.

열에 기본값이 있는 경우 배열에 null 값을 전달하여 해당 열의 기본값을 설정합니다. 마찬가지로 열에 해당 AutoIncrement 속성이 true로 설정된 경우 배열에 null 값을 전달하여 행에 대해 자동으로 생성된 값을 설정합니다.

매개 변수의 loadOption 값은 배열의 값이 기존 행에 적용되는 방법을 결정하는 데 사용됩니다. 예를 들어 가 로 설정된 경우 loadOption 각 열의 및 Current 값은 들어오는 행의 값으로 대체되고 RowState 속성은 로 Unchanged설정OverwriteChanges됩니다.Original

또는 RowChanging 이벤트 중에 예외가 ColumnChanging 발생할 수도 있습니다. 예외가 발생하면 행이 테이블에 추가되지 않습니다.

및 EndLoadData와 함께 BeginLoadData 를 사용합니다LoadDataRow.

추가 정보

• DataTables