DataTable.LoadDataRow Yöntem

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.Common.dll

Belirtilen bir satırı bulur ve güncelleştirir. Eşleşen hiçbir satır bulunamazsa, belirtilen değerleri kullanarak yeni bir satır oluşturulur.

Aşırı Yüklemeler

LoadDataRow(Object[], Boolean)	Belirtilen bir satırı bulur ve güncelleştirir. Eşleşen hiçbir satır bulunamazsa, belirtilen değerleri kullanarak yeni bir satır oluşturulur.
LoadDataRow(Object[], LoadOption)	Belirtilen bir satırı bulur ve güncelleştirir. Eşleşen hiçbir satır bulunamazsa, belirtilen değerleri kullanarak yeni bir satır oluşturulur.

LoadDataRow(Object[], Boolean)

Kaynak:

DataTable.cs

Belirtilen bir satırı bulur ve güncelleştirir. Eşleşen hiçbir satır bulunamazsa, belirtilen değerleri kullanarak yeni bir satır oluşturulur.

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

Parametreler

values

Object[]

Yeni satırı oluşturmak için kullanılan bir değer dizisi.

fAcceptChanges

Boolean

true değişiklikleri kabul etmek için; aksi takdirde false.

Döndürülenler

DataRow

Yeni DataRow.

Özel durumlar

ArgumentException

Dizi, tablodaki sütun sayısından daha büyük.

InvalidCastException

Değer ilgili sütun türüyle eşleşmiyor.

ConstraintException

Satırın eklenmesi bir kısıtlamayı geçersiz klenir.

NoNullAllowedException

False olan AllowDBNull bir sütuna null yerleştirmeye çalışılıyor.

Örnekler

Aşağıdaki örnek, bir satır bulmaya çalışmak için yöntemini kullanır LoadDataRow . Böyle bir satır bulunamazsa, değerler yeni bir satır oluşturmak için kullanılır.

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

Açıklamalar

LoadDataRow yöntemi bir değer dizisi alır ve birincil anahtar sütunlarında eşleşen değerleri bulur.

Bir sütunun varsayılan değeri varsa, bu sütunun varsayılan değerini ayarlamak için dizide null bir değer geçirin. Benzer şekilde, bir sütunun AutoIncrement özelliği true olarak ayarlanmışsa, satır için otomatik olarak oluşturulan değeri ayarlamak üzere dizide bir null değer geçirin.

fAcceptChanges Parametre belirtilirse veya belirtilmezse, yeni veriler eklenir ve bağımsız AcceptChanges değişken ise içindeki tüm değişiklikleri DataTablekabul etmek için çağrılır; bağımsız değişken isefalse, yeni eklenen satırlar ekleme olarak işaretlenir ve var olan satırlardaki değişiklikler değişiklik olarak işaretlenirtrue.

Özel durumlar bir veya RowChanging olayı sırasında ColumnChanging da oluşabilir. Bir özel durum oluşursa, satır tabloya eklenmez.

ve EndLoadDataile BeginLoadData birlikte kullanınLoadDataRow.

Ayrıca bkz.

• DataTables
• DataTable Olaylarını İşleme

LoadDataRow(Object[], LoadOption)

Kaynak:

DataTable.cs

Belirtilen bir satırı bulur ve güncelleştirir. Eşleşen hiçbir satır bulunamazsa, belirtilen değerleri kullanarak yeni bir satır oluşturulur.

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

Parametreler

values

Object[]

Yeni satırı oluşturmak için kullanılan bir değer dizisi.

loadOption

LoadOption

Dizi değerlerinin var olan bir satırdaki karşılık gelen değerlere nasıl uygulanacağını belirlemek için kullanılır.

Döndürülenler

DataRow

Yeni DataRow.

Açıklamalar

LoadDataRow yöntemi bir değer dizisi alır ve birincil anahtar sütunlarında eşleşen değerleri bulur.

Bir sütunun varsayılan değeri varsa, bu sütunun varsayılan değerini ayarlamak için dizide null bir değer geçirin. Benzer şekilde, bir sütunun AutoIncrement özelliği true olarak ayarlanmışsa, satır için otomatik olarak oluşturulan değeri ayarlamak üzere dizide bir null değer geçirin.

parametresinin loadOption değeri, dizideki değerlerin var olan bir satıra nasıl uygulandığını belirlemek için kullanılır. Örneğin, olarak ayarlanırsa loadOptionOverwriteChangesOriginal, her sütunun ve Current değerleri gelen satırdaki değerlerle değiştirilir ve RowState özelliği olarak Unchangedayarlanır.

Özel durumlar bir veya RowChanging olayı sırasında ColumnChanging da oluşabilir. Bir özel durum oluşursa, satır tabloya eklenmez.

ve EndLoadDataile BeginLoadData birlikte kullanınLoadDataRow.

Ayrıca bkz.

• DataTables