DataTable.LoadDataRow Método

Definición

Espacio de nombres:

System.Data

Ensamblados:

netstandard.dll, System.Data.Common.dll

Busca y actualiza una fila específica. Si no se encuentra ninguna fila coincidente, se crea una nueva fila con los valores especificados.

Sobrecargas

Nombre	Description
LoadDataRow(Object[], Boolean)	Busca y actualiza una fila específica. Si no se encuentra ninguna fila coincidente, se crea una nueva fila con los valores especificados.
LoadDataRow(Object[], LoadOption)	Busca y actualiza una fila específica. Si no se encuentra ninguna fila coincidente, se crea una nueva fila con los valores especificados.

LoadDataRow(Object[], Boolean)

Source:

DataTable.cs

Busca y actualiza una fila específica. Si no se encuentra ninguna fila coincidente, se crea una nueva fila con los valores especificados.

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

Parámetros

values

Object[]

Matriz de valores usados para crear la nueva fila.

fAcceptChanges

Boolean

true para aceptar cambios; de lo contrario false, es .

Devoluciones

DataRow

DataRowNuevo .

Excepciones

ArgumentException

La matriz es mayor que el número de columnas de la tabla.

InvalidCastException

Un valor no coincide con su tipo de columna correspondiente.

ConstraintException

Agregar la fila invalida una restricción.

NoNullAllowedException

Intentar colocar un valor NULL en una columna donde AllowDBNull es false.

Ejemplos

En el ejemplo siguiente se usa el LoadDataRow método para intentar buscar una fila. Si no se encuentra ninguna 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. De forma similar, 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 se true especifica o no el fAcceptChanges parámetro , se agregan los nuevos datos y, a continuaciónAcceptChanges, se llama a para aceptar todos los cambios en DataTable; si el 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

• DataTables
• Control de eventos dataTable

LoadDataRow(Object[], LoadOption)

Source:

DataTable.cs

Busca y actualiza una fila específica. Si no se encuentra ninguna fila coincidente, se crea una nueva fila con los valores especificados.

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

Parámetros

values

Object[]

Matriz de valores usados para crear la nueva fila.

loadOption

LoadOption

Se usa para determinar cómo se aplican los valores de matriz a los valores correspondientes de una fila existente.

Devoluciones

DataRow

DataRowNuevo .

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. De forma similar, 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

• DataTables