DataTable.LoadDataRow Método

Source:

DataTable.cs

Source:

DataTable.cs

Source:

DataTable.cs

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

Parámetros

Devoluciones

Nuevo objeto DataRow.

Excepciones

Ejemplos

En el ejemplo siguiente se usa el LoadDataRow método para intentar buscar una fila. Si no se encuentra dicha fila, los valores se usan para crear una nueva fila.

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

Comentarios

El LoadDataRow método toma una matriz de valores y busca los valores coincidentes en las columnas de clave principal.

Si una columna tiene un valor predeterminado, pase un valor NULL en la matriz para establecer el valor predeterminado para esa columna. Del mismo modo, si una columna tiene su AutoIncrement propiedad establecida en true, pase un valor NULL en la matriz para establecer el valor generado automáticamente para la fila.

Si el parámetro es true o no se especifica, se agregan los nuevos datos y, a continuaciónAcceptChanges, se llama a para aceptar todos los cambios en DataTable; si el fAcceptChanges argumento es false, las filas recién agregadas se marcan como inserciones y los cambios en las filas existentes se marcan como modificaciones.

Las excepciones también pueden producirse durante un ColumnChanging evento o RowChanging . Si se produce una excepción, la fila no se agrega a la tabla.

Use LoadDataRow junto con BeginLoadData y EndLoadData.

Consulte también

• Objetos DataTable
• Controlar eventos de DataTable

Source:

DataTable.cs

Source:

DataTable.cs

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);

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

Parámetros

Devoluciones

Nuevo objeto DataRow.

Comentarios

El LoadDataRow método toma una matriz de valores y busca los valores coincidentes en las columnas de clave principal.

Si una columna tiene un valor predeterminado, pase un valor NULL en la matriz para establecer el valor predeterminado para esa columna. Del mismo modo, si una columna tiene su AutoIncrement propiedad establecida en true, pase un valor NULL en la matriz para establecer el valor generado automáticamente para la fila.

El valor del loadOption parámetro se usa para determinar cómo se aplican los valores de la matriz a una fila existente. Por ejemplo, si loadOption se establece OverwriteChangesen , los Original valores y Current de cada columna se reemplazan por los valores de la fila entrante y la RowState propiedad se establece Unchangeden .

Las excepciones también pueden producirse durante un ColumnChanging evento o RowChanging . Si se produce una excepción, la fila no se agrega a la tabla.

Use LoadDataRow junto con BeginLoadData y EndLoadData.

Consulte también

• Objetos DataTable