DataGridViewRow.Clone Method ()

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Creates an exact copy of this row.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public override object Clone()

Return Value

Type: System.Object

An Object that represents the cloned DataGridViewRow.

The Clone method copies the row and its property values, but does not copy the cell values that the row contains. For information about how to copy cell values when cloning a row, see the example section.

Override the Clone method whenever you derive from DataGridViewRow and add new properties to the derived class.

Notes to Inheritors:

When overriding Clone in a derived class, call the base class's Clone method so that the properties of the base class are copied to the new row, and be sure to also copy the values of any properties that were added to the derived class.

The following example demonstrates how to use the Clone method to copy a row, and then populate the copy with the cell values from the original row.

public DataGridViewRow CloneWithValues(DataGridViewRow row)
{
    DataGridViewRow clonedRow = (DataGridViewRow)row.Clone();
    for (Int32 index = 0; index < row.Cells.Count; index++)
    {
        clonedRow.Cells[index].Value = row.Cells[index].Value;
    }
    return clonedRow;
}

.NET Framework
Available since 2.0
Return to top
Show: