DataRowCollection.Add Метод

Определение

Добавляет объект DataRow в коллекцию DataRowCollection.Adds a DataRow to the DataRowCollection.

Перегрузки

Add(DataRow)

Добавляет заданный объект DataRow в объект DataRowCollection.Adds the specified DataRow to the DataRowCollection object.

Add(Object[])

Создает строку с использованием заданных параметров и добавляет его в DataRowCollection.Creates a row using specified values and adds it to the DataRowCollection.

Add(DataRow)

Добавляет заданный объект DataRow в объект DataRowCollection.Adds the specified DataRow to the DataRowCollection object.

public:
 void Add(System::Data::DataRow ^ row);
public void Add (System.Data.DataRow row);
member this.Add : System.Data.DataRow -> unit
Public Sub Add (row As DataRow)

Параметры

row
DataRow

Добавляемый объект DataRow.The DataRow to add.

Исключения

Строка имеет значение NULL.The row is null.

Строка либо принадлежит другой таблице, либо уже принадлежит этой таблице.The row either belongs to another table or already belongs to this table.

Добавление нарушает ограничение.The addition invalidates a constraint.

Добавление пытается поместить пустое значение в объект DataColumn, свойство AllowDBNull которого имеет значение "false".The addition tries to put a null in a DataColumn where AllowDBNull is false.

Примеры

В следующем примере Add метод используется для добавления нового DataRow DataRowCollection объекта в объект.The following example uses the Add method to add a new DataRow to a DataRowCollection object.

   private void ShowRows(DataTable table)
   {
       // Print the number of rows in the collection.
       Console.WriteLine(table.Rows.Count);
       // Print the value of columns 1 in each row
       foreach(DataRow row in table.Rows)
       {
           Console.WriteLine(row[1]);
       }
   }

   private void AddRow(DataTable table)
   {
       DataRowCollection rowCollection = table.Rows;
       // Instantiate a new row using the NewRow method.

       DataRow newRow = table.NewRow();
       // Insert code to fill the row with values.

       // Add the row to the DataRowCollection.
       table.Rows.Add(newRow);
   }
Private Sub ShowRows(Byval table As DataTable)
    ' Print the number of rows in the collection.
    Console.WriteLine(table.Rows.Count)

    Dim row  As DataRow
    ' Print the value of columns 1 in each row
    For Each row In table.Rows
        Console.WriteLine(row(1))
    Next
End Sub
 
Private Sub AddRow(ByVal table As DataTable)
    ' Instantiate a new row using the NewRow method.
    Dim newRow As DataRow = table.NewRow()
    ' Insert code to fill the row with values.

    ' Add the row to the DataRowCollection.
    table.Rows.Add(newRow)
End Sub

Комментарии

Чтобы создать новый DataRowобъект, необходимо NewRow использовать метод DataTable класса.To create a new DataRow, you must use the NewRow method of the DataTable class. При использовании NewRow метода возвращается новый DataRow объект, использующий схему родителя DataTable.When you use the NewRow method, a new DataRow object is returned using the schema of parent DataTable. После создания DataRow объекта и установки значений для каждого из его столбцов Add используйте метод, чтобы добавить объект в коллекцию.After you create the DataRow object and set the values for each of its columns, use the Add method to add the object to the collection.

Создает исключение, если пользователь создает исключение в RowChanging событии.Generates an exception if the user generates an exception in the RowChanging event. При возникновении исключения строка не добавляется в таблицу.If an exception occurs, the row is not added to the table.

Дополнительно

Add(Object[])

Создает строку с использованием заданных параметров и добавляет его в DataRowCollection.Creates a row using specified values and adds it to the DataRowCollection.

public:
 virtual System::Data::DataRow ^ Add(cli::array <System::Object ^> ^ values);
public virtual System.Data.DataRow Add (object[] values);
abstract member Add : obj[] -> System.Data.DataRow
override this.Add : obj[] -> System.Data.DataRow
Public Overridable Function Add (values As Object()) As DataRow

Параметры

values
Object[]

Массив значений, который используются для создания новой строки.The array of values that are used to create the new row.

Возвраты

Отсутствует.None.

Исключения

Размер массива превышает число столбцов в таблице.The array is larger than the number of columns in the table.

Значение не соответствует соответствующему типу столбца.A value does not match its respective column type.

Добавление строки нарушает ограничение.Adding the row invalidates a constraint.

Попытка поместить значение NULL в столбец, где AllowDBNull имеет значение "false".Trying to put a null in a column where AllowDBNull is false.

Примеры

В следующем примере используется Add метод для создания и добавления нового DataRow объекта в DataRowCollection.The following example uses the Add method to create and add a new DataRow object to a DataRowCollection.

private void AddRow(DataTable table)
{
    // Create an array with three elements.
    object[] rowVals = new object[3];
    DataRowCollection rowCollection = table.Rows;
    rowVals[0] = "hello";
    rowVals[1] = "world";
    rowVals[2] = "two";

    // Add and return the new row.
    DataRow row = rowCollection.Add(rowVals);
}
Private Sub AddRow(ByVal table As DataTable)
    ' Create an array with three elements.
    Dim rowVals(2) As Object
    Dim rowCollection As DataRowCollection = table.Rows
    rowVals(0) = "hello"
    rowVals(1) = "world"
    rowVals(2) = "two"

    ' Add and return the new row.
    Dim row As DataRow = rowCollection.Add(rowVals) 
End Sub

Комментарии

DataColumn Если объектAutoIncrement имеет значение true, то для получения значения по умолчанию для этого столбца передается значение null.If a DataColumn object has its AutoIncrement set to True, null should be passed to get the default value for that column.

Исключения также могут возникать при возникновении исключения во время ColumnChanging события или. RowChangingExceptions can also occur if you generate an exception during either a ColumnChanging or RowChanging event. При возникновении исключения строка не добавляется в таблицу.If an exception occurs, the row is not added to the table.

Дополнительно

Применяется к