DataTable.LoadDataRow Método

Definición

Busca y actualiza una fila específica.Finds and updates a specific row. Si no encuentra ninguna fila coincidente, se crea una nueva con los valores dados.If no matching row is found, a new row is created using the given values.

Sobrecargas

LoadDataRow(Object[], Boolean)

Busca y actualiza una fila específica.Finds and updates a specific row. Si no encuentra ninguna fila coincidente, se crea una nueva con los valores dados.If no matching row is found, a new row is created using the given values.

LoadDataRow(Object[], LoadOption)

Busca y actualiza una fila específica.Finds and updates a specific row. Si no encuentra ninguna fila coincidente, se crea una nueva con los valores dados.If no matching row is found, a new row is created using the given values.

LoadDataRow(Object[], Boolean)

Busca y actualiza una fila específica.Finds and updates a specific row. Si no encuentra ninguna fila coincidente, se crea una nueva con los valores dados.If no matching row is found, a new row is created using the given values.

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.An array of values used to create the new row.

fAcceptChanges
Boolean

true para aceptar los cambios; de lo contrario, false.true to accept changes; otherwise false.

Devoluciones

Nuevo objeto DataRow.The new DataRow.

Excepciones

La matriz es mayor que el número de columnas de la tabla.The array is larger than the number of columns in the table.

Un valor no coincide con su tipo de columna respectivo.A value doesn't match its respective column type.

La adición de la fila invalida una restricción.Adding the row invalidates a constraint.

Intento de colocar un valor nulo donde AllowDBNull sea falso.Attempting to put a null in a column where AllowDBNull is false.

Ejemplos

En el ejemplo siguiente se LoadDataRow usa el método para intentar buscar una fila.The following example uses the LoadDataRow method to attempt to find a row. Si no se encuentra ninguna fila, los valores se usan para crear una nueva fila.If no such row is found, the values are used to create a new row.

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.The LoadDataRow method takes an array of values and finds the matching value(s) in the primary key column(s).

Si una columna tiene un valor predeterminado, pase un valor null en la matriz para establecer el valor predeterminado de esa columna.If a column has a default value, pass a null value in the array to set the default value for that column. Del mismo modo, si una columna AutoIncrement tiene su propiedad establecida en true, pase un valor null en la matriz para establecer el valor generado automáticamente para la fila.Similarly, if a column has its AutoIncrement property set to true, pass a null value in the array to set the automatically generated value for the row.

Si el fAcceptChanges parámetro es true o no se especifica, se agregan los nuevos datos AcceptChanges y, a continuación, DataTablese llama a para aceptar todos los cambios falseen; si el argumento es, las filas recién agregadas se marcan como inserciones y cambios en las filas existentes se marcan como modificaciones.If the fAcceptChanges parameter is true or not specified, the new data is added and then AcceptChanges is called to accept all changes in the DataTable; if the argument is false, newly added rows are marked as insertions, and changes to existing rows are marked as modifications.

Las excepciones también pueden producirse durante ColumnChanging un RowChanging evento o.Exceptions can also occur during either a ColumnChanging or RowChanging event. Si se produce una excepción, la fila no se agrega a la tabla.If an exception occurs, the row is not added to the table.

Use LoadDataRow junto con BeginLoadData y. EndLoadDataUse LoadDataRow in conjunction with BeginLoadData and EndLoadData.

Consulte también:

LoadDataRow(Object[], LoadOption)

Busca y actualiza una fila específica.Finds and updates a specific row. Si no encuentra ninguna fila coincidente, se crea una nueva con los valores dados.If no matching row is found, a new row is created using the given values.

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

Parámetros

values
Object[]

Matriz de valores utilizada para crear la nueva fila.An array of values used to create the new row.

loadOption
LoadOption

Se utiliza para determinar cómo se aplican los valores de la matriz a los valores correspondientes en una fila existente.Used to determine how the array values are applied to the corresponding values in an existing row.

Devoluciones

Nuevo objeto DataRow.The new DataRow.

Comentarios

El LoadDataRow método toma una matriz de valores y busca los valores coincidentes en las columnas de clave principal.The LoadDataRow method takes an array of values and finds the matching value(s) in the primary key column(s).

Si una columna tiene un valor predeterminado, pase un valor null en la matriz para establecer el valor predeterminado de esa columna.If a column has a default value, pass a null value in the array to set the default value for that column. Del mismo modo, si una columna AutoIncrement tiene su propiedad establecida en true, pase un valor null en la matriz para establecer el valor generado automáticamente para la fila.Similarly, if a column has its AutoIncrement property set to true, pass a null value in the array to set the automatically generated value for the row.

El valor del loadOption parámetro se usa para determinar cómo se aplican los valores de la matriz a una fila existente.The value of the loadOption parameter is used to determine how the values in the array are applied to an existing row. Por ejemplo, si loadOption se establece en OverwriteChanges, los Original valores Current y de cada columna se reemplazan por los valores de la fila entrante y RowState la propiedad se establece Unchangeden.For example, if loadOption is set to OverwriteChanges, the Original and Current values of each column are replaced with the values in the incoming row and the RowState property is set to Unchanged.

Las excepciones también pueden producirse durante ColumnChanging un RowChanging evento o.Exceptions can also occur during either a ColumnChanging or RowChanging event. Si se produce una excepción, la fila no se agrega a la tabla.If an exception occurs, the row is not added to the table.

Use LoadDataRow junto con BeginLoadData y. EndLoadDataUse LoadDataRow in conjunction with BeginLoadData and EndLoadData.

Consulte también:

Se aplica a