Поделиться через


DataRowCollection.Add Метод

Определение

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

Перегрузки

Add(DataRow)

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

Add(Object[])

Создает строку с использованием заданных параметров и добавляет его в DataRowCollection.

Add(DataRow)

Исходный код:
DataRowCollection.cs
Исходный код:
DataRowCollection.cs
Исходный код:
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.

Исключения

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

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

Добавление нарушает ограничение.

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

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

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

Add(Object[])

Исходный код:
DataRowCollection.cs
Исходный код:
DataRowCollection.cs
Исходный код:
DataRowCollection.cs

Создает строку с использованием заданных параметров и добавляет его в DataRowCollection.

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

Параметры

values
Object[]

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

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

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

Исключения

Размер массива превышает число столбцов в таблице.

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

Добавление строки нарушает ограничение.

Попытка поместить значение 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 . При возникновении исключения строка не добавляется в таблицу.

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

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