DataGridViewCell.GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts) Metoda

Definicja

Zwraca bieżącą, sformatowaną wartość komórki, bez względu na to, czy komórka jest w trybie edycji, a wartość nie została zatwierdzona.Returns the current, formatted value of the cell, regardless of whether the cell is in edit mode and the value has not been committed.

public:
 System::Object ^ GetEditedFormattedValue(int rowIndex, System::Windows::Forms::DataGridViewDataErrorContexts context);
public object GetEditedFormattedValue (int rowIndex, System.Windows.Forms.DataGridViewDataErrorContexts context);
member this.GetEditedFormattedValue : int * System.Windows.Forms.DataGridViewDataErrorContexts -> obj
Public Function GetEditedFormattedValue (rowIndex As Integer, context As DataGridViewDataErrorContexts) As Object

Parametry

rowIndex
Int32

Indeks wiersza komórki.The row index of the cell.

context
DataGridViewDataErrorContexts

Bitowa kombinacja wartości DataGridViewDataErrorContexts, które określają kontekst błędu danych.A bitwise combination of DataGridViewDataErrorContexts values that specifies the data error context.

Zwraca

Bieżąca sformatowana wartość DataGridViewCell.The current, formatted value of the DataGridViewCell.

Wyjątki

Określony rowIndex jest mniejszy niż 0 lub większy niż liczba wierszy w kontrolce pomniejszonej o 1.The specified rowIndex is less than 0 or greater than the number of rows in the control minus 1.

ColumnIndex jest mniejsza niż 0, co oznacza, że komórka jest komórką nagłówka wiersza.ColumnIndex is less than 0, indicating that the cell is a row header cell.

Formatowanie nie powiodło się i nie ma procedury obsługi dla zdarzenia DataError kontrolki DataGridView lub program obsługi ustawił Właściwość ThrowException na true.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. Obiekt wyjątku może być zazwyczaj rzutowany na typ FormatException.The exception object can typically be cast to type FormatException.

Uwagi

Ta metoda zwraca bieżącą wartość edytowanej komórki lub kontrolki edycji, jeśli komórka jest w trybie edycji.This method returns the current value of the editing cell or editing control if the cell is in edit mode. W przeciwnym razie ta metoda konwertuje wartość komórki na równoważną wartość wyświetlaną typu wskazywanego przez właściwość FormattedValueType.Otherwise, this method converts the cell value into an equivalent display value of the type indicated by the FormattedValueType property. Wywołuje zdarzenie DataGridView.CellFormatting, które można obsłużyć w celu dostosowania konwersji wartości.This raises the DataGridView.CellFormatting event, which you can handle to customize the value conversion.

Jeśli formatowanie nie powiedzie się, wystąpi zdarzenie DataGridView.DataError.If formatting is unsuccessful, the DataGridView.DataError event occurs. Jeśli nie ma obsługi dla tego zdarzenia lub program obsługi ustawi właściwość DataGridViewDataErrorEventArgs.ThrowException na true, zostanie zgłoszony wyjątek.If there is no handler for this event or the handler sets the DataGridViewDataErrorEventArgs.ThrowException property to true, an exception is thrown.

Klasy pochodne, które przesłonić tę metodę, zazwyczaj zwracają ciąg reprezentujący wartość komórki, jeśli argument context zawiera wartość ClipboardContent.Derived classes that override this method will typically return a string representation of the cell value if the context argument includes the ClipboardContent value.

Dotyczy

Zobacz też