DataTable.LoadDataRow Metode

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Menemukan dan memperbarui baris tertentu. Jika tidak ada baris yang cocok yang ditemukan, baris baru dibuat menggunakan nilai yang diberikan.

Overload

LoadDataRow(Object[], Boolean)	Menemukan dan memperbarui baris tertentu. Jika tidak ada baris yang cocok yang ditemukan, baris baru dibuat menggunakan nilai yang diberikan.
LoadDataRow(Object[], LoadOption)	Menemukan dan memperbarui baris tertentu. Jika tidak ada baris yang cocok yang ditemukan, baris baru dibuat menggunakan nilai yang diberikan.

LoadDataRow(Object[], Boolean)

Sumber:

DataTable.cs

Menemukan dan memperbarui baris tertentu. Jika tidak ada baris yang cocok yang ditemukan, baris baru dibuat menggunakan nilai yang diberikan.

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

Parameter

values

Object[]

Array nilai yang digunakan untuk membuat baris baru.

fAcceptChanges

Boolean

true untuk menerima perubahan; jika tidak false.

Mengembalikan

DataRow

Yang baru DataRow.

Pengecualian

ArgumentException

Array lebih besar dari jumlah kolom dalam tabel.

InvalidCastException

Nilai tidak cocok dengan jenis kolom masing-masing.

ConstraintException

Menambahkan baris membatalkan batasan.

NoNullAllowedException

Mencoba untuk menempatkan null di kolom di mana AllowDBNull false.

Contoh

Contoh berikut menggunakan LoadDataRow metode untuk mencoba menemukan baris. Jika tidak ada baris seperti itu yang ditemukan, nilai digunakan untuk membuat baris baru.

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

Keterangan

Metode ini LoadDataRow mengambil array nilai dan menemukan nilai yang cocok di kolom kunci primer.

Jika kolom memiliki nilai default, berikan nilai null dalam array untuk mengatur nilai default untuk kolom tersebut. Demikian pula, jika kolom memiliki properti yang AutoIncrement diatur ke true, teruskan nilai null dalam array untuk mengatur nilai yang dihasilkan secara otomatis untuk baris.

fAcceptChanges Jika parameter ditentukan true atau tidak ditentukan, data baru ditambahkan lalu AcceptChanges dipanggil untuk menerima semua perubahan dalam DataTable; jika argumen adalah false, baris yang baru ditambahkan ditandai sebagai penyisipan, dan perubahan pada baris yang ada ditandai sebagai modifikasi.

Pengecualian juga dapat terjadi selama peristiwa ColumnChanging atau RowChanging . Jika terjadi pengecualian, baris tidak ditambahkan ke tabel.

Gunakan LoadDataRow bersama dengan BeginLoadData dan EndLoadData.

Lihat juga

• DataTables
• Menangani Peristiwa DataTable

LoadDataRow(Object[], LoadOption)

Sumber:

DataTable.cs

Menemukan dan memperbarui baris tertentu. Jika tidak ada baris yang cocok yang ditemukan, baris baru dibuat menggunakan nilai yang diberikan.

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

Parameter

values

Object[]

Array nilai yang digunakan untuk membuat baris baru.

loadOption

LoadOption

Digunakan untuk menentukan bagaimana nilai array diterapkan ke nilai terkait di baris yang sudah ada.

Mengembalikan

DataRow

Yang baru DataRow.

Keterangan

Metode ini LoadDataRow mengambil array nilai dan menemukan nilai yang cocok di kolom kunci primer.

Jika kolom memiliki nilai default, berikan nilai null dalam array untuk mengatur nilai default untuk kolom tersebut. Demikian pula, jika kolom memiliki properti yang AutoIncrement diatur ke true, teruskan nilai null dalam array untuk mengatur nilai yang dihasilkan secara otomatis untuk baris.

Nilai loadOption parameter digunakan untuk menentukan bagaimana nilai dalam array diterapkan ke baris yang sudah ada. Misalnya, jika loadOption diatur ke OverwriteChanges, Original nilai dan Current dari setiap kolom diganti dengan nilai di baris masuk dan RowState properti diatur ke Unchanged.

Pengecualian juga dapat terjadi selama peristiwa ColumnChanging atau RowChanging . Jika terjadi pengecualian, baris tidak ditambahkan ke tabel.

Gunakan LoadDataRow bersama dengan BeginLoadData dan EndLoadData.

Lihat juga

• DataTables