DataGridViewCell.GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String) DataGridViewCell.GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String) DataGridViewCell.GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String) DataGridViewCell.GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String) Method

Definition

Ruft den formatierten Wert der Zelle ab, der nach Clipboard kopiert werden soll.Retrieves the formatted value of the cell to copy to the Clipboard.

protected:
 virtual System::Object ^ GetClipboardContent(int rowIndex, bool firstCell, bool lastCell, bool inFirstRow, bool inLastRow, System::String ^ format);
protected virtual object GetClipboardContent (int rowIndex, bool firstCell, bool lastCell, bool inFirstRow, bool inLastRow, string format);
abstract member GetClipboardContent : int * bool * bool * bool * bool * string -> obj
override this.GetClipboardContent : int * bool * bool * bool * bool * string -> obj
Protected Overridable Function GetClipboardContent (rowIndex As Integer, firstCell As Boolean, lastCell As Boolean, inFirstRow As Boolean, inLastRow As Boolean, format As String) As Object

Parameter

rowIndex
Int32 Int32 Int32 Int32

Der auf 0 (null) basierende Index der Zeile, die die Zelle enthält.The zero-based index of the row containing the cell.

firstCell
Boolean Boolean Boolean Boolean

true, um anzuzeigen, dass sich die Zelle in der ersten Spalte des durch die ausgewählten Zellen definierten Bereichs befindet, andernfalls false.true to indicate that the cell is in the first column of the region defined by the selected cells; otherwise, false.

lastCell
Boolean Boolean Boolean Boolean

true, um anzuzeigen, dass die Zelle die letzte Spalte des durch die ausgewählten Zellen definierten Bereichs ist, andernfalls false.true to indicate that the cell is the last column of the region defined by the selected cells; otherwise, false.

inFirstRow
Boolean Boolean Boolean Boolean

true, um anzuzeigen, dass sich die Zelle in der ersten Zeile des durch die ausgewählten Zellen definierten Bereichs befindet, andernfalls false.true to indicate that the cell is in the first row of the region defined by the selected cells; otherwise, false.

inLastRow
Boolean Boolean Boolean Boolean

true, um anzugeben, dass sich die Zelle in der letzten Zeile des durch die ausgewählten Zellen definierten Bereichs befindet, andernfalls false.true to indicate that the cell is in the last row of the region defined by the selected cells; otherwise, false.

format
String String String String

Die aktuelle Formatzeichenfolge der Zelle.The current format string of the cell.

Gibt zurück

Ein Object, das den Wert der Zelle darstellt, die in die Clipboard kopiert werden soll.An Object that represents the value of the cell to copy to the Clipboard.

Ausnahmen

rowIndex ist kleiner als 0 (null) bzw. größer oder gleich der Anzahl der Zeilen im Steuerelement.rowIndex is less than 0 or greater than or equal to the number of rows in the control.

Der Wert der DataGridView-Eigenschaft der Zelle ist null.The value of the cell's DataGridView property is null.

- oder --or- ColumnIndex ist kleiner als 0 (null). Das bedeutet, dass die Zelle eine Zeilenheaderzelle darstellt.ColumnIndex is less than 0, indicating that the cell is a row header cell.

Bei der Formatierung sind Fehler aufgetreten. Entweder ist kein Handler für das DataError-Ereignis des DataGridView-Steuerelements vorhanden, oder der Handler hat die ThrowException-Eigenschaft auf true festgelegt.Formatting failed and either there is no handler for the DataError event of the DataGridView control or the handler set the ThrowException property to true. Das Ausnahmeobjekt kann in der Regel in den Typ FormatException umgewandelt werden.The exception object can typically be cast to type FormatException.

Hinweise

Diese Methode wird aufgerufen, indem die DataGridView.GetClipboardContent Methode, um einen Zwischenablage formatierter Wert abzurufen, die der Wert der Zelle darstellt.This method is called by the DataGridView.GetClipboardContent method to retrieve a Clipboard-formatted value that represents the cell value.

Der Wert der Zelle wird zuerst abgerufen, in das Anzeigeformat von der GetEditedFormattedValue Methode.The cell value is first retrieved in its display format from the GetEditedFormattedValue method. Dadurch wird möglicherweise ausgelöst, die DataGridView.CellFormatting Ereignis zum Formatieren des Werts und der DataGridView.DataError Ereignis, wenn die Formatierung nicht erfolgreich ist.This may raise the DataGridView.CellFormatting event to format the value and the DataGridView.DataError event if formatting is unsuccessful.

Die Position Parameter dieser Methode anzugeben, wo sich diese Zelle in der Tabelle der Daten, die durch in der ausgewählten Zellen definierten Bereichs befindet der DataGridView Steuerelement.The position-related parameters of this method indicate where this cell is located in the table of data representing the region defined by the selected cells in the DataGridView control. Abhängig von der Position der Zelle kann die zusätzlichen Formatierungsinformationen durch diese Methode zusammen mit dem Zellenwert für die Anzeige formatierte zurückgegeben werden.Depending on the cell's position, additional formatting information may be returned by this method along with the display-formatted cell value. HTML-Format für eine Zelle in der ersten Spalte einer Zeile wird beispielsweise das Tag enthalten, das den Anfang einer Zeile angibt.For example, the HTML format for a cell in the first column of a row will include the tag that indicates the beginning of a row.

Die unterstützten Zwischenablageformate DataFormats.Text, DataFormats.UnicodeText, DataFormats.Html, und DataFormats.CommaSeparatedValue.The supported Clipboard formats include DataFormats.Text, DataFormats.UnicodeText, DataFormats.Html, and DataFormats.CommaSeparatedValue.

Weitere Informationen finden Sie in den Ausführungen zur Clipboard-Klasse.For more information, see the Clipboard class.

Hinweise für Vererber

Überschreiben Sie diese Methode, um die benutzerdefinierten Zwischenablagewerte bereitstellen.Override this method to provide customized Clipboard values. Beispielsweise können Sie diese Methode, um das Kopieren von Werten aus benutzerdefinierten Zelltypen unterstützen überschreiben.For example, you could override this method to support copying values from custom cell types.

Gilt für:

Siehe auch