DataTable.LoadDataRow 메서드

정의

네임스페이스:

System.Data

어셈블리:

netstandard.dll, System.Data.Common.dll

특정 행을 찾아 업데이트합니다. 일치하는 행이 없으면 지정된 값을 사용하여 새 행이 만들어집니다.

오버로드

Name	Description
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

false인 열 AllowDBNull 에 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 호출되어 인수false가 있으면 새로 DataTable추가된 행이 삽입으로 표시되고 기존 행에 대한 변경 내용이 수정으로 표시됩니다.

예외는 a 또는 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 값이 기존 행에 적용되는 방식을 결정하는 데 사용됩니다. 예를 들어 설정된 OverwriteChangesOriginal 경우 loadOption 각 열의 값과 Current 값은 들어오는 행의 값으로 대체되고 RowState 속성은 로 Unchanged설정됩니다.

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

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

추가 정보

• DataTables