DataRowCollection.Add DataRowCollection.Add DataRowCollection.Add DataRowCollection.Add Method

Определение

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

Перегрузки

Add(DataRow) Add(DataRow) Add(DataRow) Add(DataRow)

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

Add(Object[]) Add(Object[]) Add(Object[]) Add(Object[])

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

Add(DataRow) Add(DataRow) Add(DataRow) 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 DataRow 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[]) Add(Object[]) Add(Object[]) Add(Object[])

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

public:
 System::Data::DataRow ^ Add(... cli::array <System::Object ^> ^ values);
public System.Data.DataRow Add (params object[] values);
member this.Add : obj[] -> System.Data.DataRow
Public Function Add (ParamArray 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 или RowChanging событий.Exceptions 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.

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

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