DataRowCollection.Add Yöntem

Tanım

DataRowÖğesine öğesine ekler DataRowCollection .Adds a DataRow to the DataRowCollection.

Aşırı Yüklemeler

Add(DataRow)

Belirtilen nesneye ekler DataRow DataRowCollection .Adds the specified DataRow to the DataRowCollection object.

Add(Object[])

Belirtilen değerleri kullanarak bir satır oluşturur ve içine ekler DataRowCollection .Creates a row using specified values and adds it to the DataRowCollection.

Add(DataRow)

Belirtilen nesneye ekler 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)

Parametreler

row
DataRow

DataRowEklemek için.The DataRow to add.

Özel durumlar

Satır null.The row is null.

Satır başka bir tabloya ait veya zaten bu tabloya ait.The row either belongs to another table or already belongs to this table.

Ekleme bir kısıtlamayı geçersiz kılar.The addition invalidates a constraint.

Ek olarak, bir içinde null değeri bir olan ' a koymaya çalışır DataColumn AllowDBNull .The addition tries to put a null in a DataColumn where AllowDBNull is false.

Örnekler

Aşağıdaki örnek, Add bir nesnesine yeni bir eklemek için yöntemini kullanır 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

Açıklamalar

Yeni bir oluşturmak için DataRow , sınıfının yöntemini kullanmanız gerekir NewRow DataTable .To create a new DataRow, you must use the NewRow method of the DataTable class. NewRowYöntemini kullandığınızda, DataRow Parent şeması kullanılarak yeni bir nesne döndürülür DataTable .When you use the NewRow method, a new DataRow object is returned using the schema of parent DataTable. DataRowNesnesini oluşturduktan ve sütunlarının her biri için değerleri ayarladıktan sonra, Add nesneyi koleksiyona eklemek için yöntemini kullanın.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.

Kullanıcı olayda bir özel durum oluşturursa bir özel durum oluşturur RowChanging .Generates an exception if the user generates an exception in the RowChanging event. Bir özel durum oluşursa, satır tabloya eklenmez.If an exception occurs, the row is not added to the table.

Ayrıca bkz.

Şunlara uygulanır

Add(Object[])

Belirtilen değerleri kullanarak bir satır oluşturur ve içine ekler DataRowCollection .Creates a row using specified values and adds it to the 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

Parametreler

values
Object[]

Yeni satırı oluşturmak için kullanılan değerlerin dizisi.The array of values that are used to create the new row.

Döndürülenler

DataRow

Yok.None.

Özel durumlar

Dizi, tablodaki sütun sayısından daha büyük.The array is larger than the number of columns in the table.

Değer, ilgili sütun türüyle eşleşmiyor.A value does not match its respective column type.

Satırı eklemek bir kısıtlamayı geçersiz kılar.Adding the row invalidates a constraint.

False olan bir sütuna null koymaya çalışılıyor AllowDBNull .Trying to put a null in a column where AllowDBNull is false.

Örnekler

Aşağıdaki örnek, öğesini Add oluşturmak ve öğesine yeni bir nesnesi eklemek için yöntemini kullanır 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

Açıklamalar

Bir DataColumn nesne AutoIncrement true olarak ayarlandıysa, bu sütun için varsayılan değeri almak üzere null değer geçirilmelidir.If a DataColumn object has its AutoIncrement set to True, null should be passed to get the default value for that column.

Ya da bir olay sırasında özel durum oluşturursanız, özel durumlar da ColumnChanging oluşabilir RowChanging .Exceptions can also occur if you generate an exception during either a ColumnChanging or RowChanging event. Bir özel durum oluşursa, satır tabloya eklenmez.If an exception occurs, the row is not added to the table.

Ayrıca bkz.

Şunlara uygulanır