DataRowCollection.Add Метод

Определение

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

System.Data

Сборка:

System.Data.Common.dll

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

Перегрузки

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

Add(DataRow)

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

DataRowCollection.cs

Добавляет заданный объект DataRow в объект DataRowCollection.

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

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

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

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

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