DataGridViewCell.GetClipboardContent Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Recupera il valore formattato della cella da copiare nell'oggetto 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);

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

Parametri

rowIndex: Int32

Indice in base zero della riga contenente la cella.

firstCell: Boolean

true per indicare che la cella è nella prima colonna dell'area definita dalle celle selezionate; in caso contrario, false.

lastCell: Boolean

true per indicare che la cella è nell'ultima colonna dell'area definita dalle celle selezionate; in caso contrario, false.

inFirstRow: Boolean

true per indicare che la cella è nella prima riga dell'area definita dalle celle selezionate; in caso contrario, false.

inLastRow: Boolean

true per indicare che la cella è nell'ultima riga dell'area definita dalle celle selezionate; in caso contrario, false.

format: String

Stringa di formato corrente della cella.

Restituisce

Object

Classe Object che rappresenta il valore della cella da copiare nella classe Clipboard.

Eccezioni

ArgumentOutOfRangeException

Il parametro rowIndex è minore di 0 oppure è maggiore o uguale al numero di righe nel controllo.

InvalidOperationException

Il valore della proprietà DataGridView della cella è null.

-oppure-

La proprietà ColumnIndex è minore di 0, a indicare che la cella è un cella di intestazione di riga.

Exception

La formattazione non è riuscita e non esiste alcun gestore per l'evento DataError del controllo DataGridView oppure il gestore ha impostato la proprietà ThrowException su true. In genere è possibile eseguire il cast dell'oggetto eccezione al tipo FormatException.

Commenti

Questo metodo viene chiamato dal DataGridView.GetClipboardContent metodo per recuperare un valore formattato dagli Appunti che rappresenta il valore della cella.

Il valore della GetEditedFormattedValue cella viene prima recuperato nel formato visualizzato dal metodo . Questo può generare l'evento per formattare il valore e l'evento DataGridView.CellFormatting se la DataGridView.DataError formattazione non è riuscita.

I parametri correlati alla posizione di questo metodo indicano dove questa cella si trova nella tabella dei dati che rappresentano l'area definita dalle celle selezionate nel DataGridView controllo. A seconda della posizione della cella, è possibile restituire informazioni aggiuntive sulla formattazione tramite questo metodo insieme al valore della cella formattato dalla visualizzazione. Ad esempio, il formato HTML per una cella nella prima colonna di una riga includerà il tag che indica l'inizio di una riga.

I formati supportati negli Appunti includono DataFormats.Text, , DataFormats.UnicodeText DataFormats.Htmle DataFormats.CommaSeparatedValue.

Per altre informazioni, vedere la classe Clipboard.

Note per gli eredi

Eseguire l'override di questo metodo per fornire valori personalizzati degli Appunti. Ad esempio, è possibile eseguire l'override di questo metodo per supportare la copia dei valori dai tipi di cella personalizzati.

Si applica a