DataTable.LoadDataRow Método

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

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

Sobrecargas

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

LoadDataRow(Object[], Boolean)

Source:

DataTable.cs

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

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 utilizada para crear la nueva fila.

fAcceptChanges

Boolean

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

Devoluciones

DataRow

Nuevo objeto DataRow.

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 respectivo.

ConstraintException

La adición de la fila invalida una restricción.

NoNullAllowedException

Intento de colocar un valor nulo donde AllowDBNull sea falso.

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. 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 el fAcceptChanges parámetro es true o no se especifica, se agregan los nuevos datos y, a continuación AcceptChanges , 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

• Objetos DataTable
• Controlar eventos de DataTable

LoadDataRow(Object[], LoadOption)

Source:

DataTable.cs

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

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 utilizada para crear la nueva fila.

loadOption

LoadOption

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

Devoluciones

DataRow

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. 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

• Objetos DataTable