DataRowCollection.Add Метод

Определение

Пространство имен:

System.Data

Сборки:

netstandard.dll, System.Data.Common.dll

Добавляет DataRow в DataRowCollection.

Перегрузки

Имя	Описание
Add(DataRow)	Добавляет указанный DataRowDataRowCollection объект.
Add(Object[])	Создает строку с помощью указанных значений DataRowCollectionи добавляет ее в .

Add(DataRow)

Исходный код:

DataRowCollection.cs

Добавляет указанный DataRowDataRowCollection объект.

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 объект.

Исключения

ArgumentNullException

Строка имеет значение NULL.

ArgumentException

Строка принадлежит другой таблице или уже принадлежит этой таблице.

ConstraintException

Добавление отменяет ограничение.

NoNullAllowedException

Добавление пытается поместить значение NULL в значение DataColumnAllowDBNull false.

Примеры

В следующем примере метод используется Add для добавления нового DataRow объекта DataRowCollection .

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 класса. При использовании NewRow метода возвращается новый DataRow объект с помощью схемы родительского DataTableобъекта. После создания DataRow объекта и задания значений для каждого столбца используйте Add метод, чтобы добавить объект в коллекцию.

Создает исключение, если пользователь создает исключение в событии RowChanging . Если возникает исключение, строка не добавляется в таблицу.

См. также раздел

• Clear()
• DataTable
• DataRow
• NewRow()
• Remove(DataRow)

Add(Object[])

Исходный код:

DataRowCollection.cs

Создает строку с помощью указанных значений 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[]

Массив значений, используемых для создания новой строки.

Возвращаемое значение

DataRow

Новая строка.

Исключения

ArgumentException

Массив больше количества столбцов в таблице.

InvalidCastException

Значение не соответствует соответствующему типу столбца.

ConstraintException

Добавление строки недопустимым ограничением.

NoNullAllowedException

Попытка поместить значение NULL в столбец, где AllowDBNull имеет значение false.

Примеры

В следующем примере метод используется Add для создания и добавления нового DataRow объекта в объект 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, чтобы получить значение по умолчанию для этого столбца.

Исключения также могут возникать при создании исключения во время или ColumnChangingRowChanging события. Если возникает исключение, строка не добавляется в таблицу.

См. также раздел

• Clear()
• DataTable
• DataRow
• NewRow()
• Remove(DataRow)