DataGridViewRow.Clone Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Creates an exact copy of this row.
public:
override System::Object ^ Clone();public override object Clone ();override this.Clone : unit -> objPublic Overrides Function Clone () As ObjectReturns
An Object that represents the cloned DataGridViewRow.
Examples
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;
}
Public Function CloneWithValues(ByVal row As DataGridViewRow) _
As DataGridViewRow
CloneWithValues = CType(row.Clone(), DataGridViewRow)
For index As Int32 = 0 To row.Cells.Count - 1
CloneWithValues.Cells(index).Value = row.Cells(index).Value
Next
End Function
Remarks
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.
