Bagikan melalui


DataTable.LoadDataRow Metode

Definisi

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
Sumber:
DataTable.cs
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);
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

Yang baru DataRow.

Pengecualian

Array lebih besar dari jumlah kolom dalam tabel.

Nilai tidak cocok dengan jenis kolom masing-masing.

Menambahkan baris membatalkan batasan.

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

Berlaku untuk

LoadDataRow(Object[], LoadOption)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
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);
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

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

Berlaku untuk