DataControlField.ExtractValuesFromCell Metodo

public:
 virtual void ExtractValuesFromCell(System::Collections::Specialized::IOrderedDictionary ^ dictionary, System::Web::UI::WebControls::DataControlFieldCell ^ cell, System::Web::UI::WebControls::DataControlRowState rowState, bool includeReadOnly);

public virtual void ExtractValuesFromCell (System.Collections.Specialized.IOrderedDictionary dictionary, System.Web.UI.WebControls.DataControlFieldCell cell, System.Web.UI.WebControls.DataControlRowState rowState, bool includeReadOnly);

abstract member ExtractValuesFromCell : System.Collections.Specialized.IOrderedDictionary * System.Web.UI.WebControls.DataControlFieldCell * System.Web.UI.WebControls.DataControlRowState * bool -> unit
override this.ExtractValuesFromCell : System.Collections.Specialized.IOrderedDictionary * System.Web.UI.WebControls.DataControlFieldCell * System.Web.UI.WebControls.DataControlRowState * bool -> unit

Public Overridable Sub ExtractValuesFromCell (dictionary As IOrderedDictionary, cell As DataControlFieldCell, rowState As DataControlRowState, includeReadOnly As Boolean)

Parametri

Esempio

Nell'esempio DataControlField di codice seguente viene illustrato come implementare il ExtractValuesFromCell metodo per un controllo che deriva dalla classe . La RadioButtonField classe esegue il rendering di un pulsante di opzione associato a dati per ogni riga in un GridView controllo. Quando viene chiamato il metodo, il ExtractValuesFromCell metodo tenta di determinare se il valore corrente dell'oggetto RadioButton contenuto nella cella è selezionato o cancellato e aggiunge il valore alla IDictionary raccolta. Questo esempio di codice fa parte di un esempio più grande fornito per la DataControlField classe.

// This method is called by the ExtractRowValues methods of 
// GridView and DetailsView. Retrieve the current value of the 
// cell from the Checked state of the Radio button.
public override void ExtractValuesFromCell(IOrderedDictionary dictionary,
                                           DataControlFieldCell cell,
                                           DataControlRowState rowState,
                                           bool includeReadOnly)
{

  // Determine whether the cell contains a RadioButton 
  // in its Controls collection.
  if (cell.Controls.Count > 0) {
    RadioButton radio = cell.Controls[0] as RadioButton;

    object checkedValue = null;
    if (null == radio) {
      // A RadioButton is expected, but a null is encountered.
      // Add error handling.
      throw new InvalidOperationException
          ("RadioButtonField could not extract control.");
    }
    else {
        checkedValue = radio.Checked;
    }

    // Add the value of the Checked attribute of the
    // RadioButton to the dictionary.
    if (dictionary.Contains(DataField))
      dictionary[DataField] = checkedValue;
    else
      dictionary.Add(DataField, checkedValue);
  }
}

' This method is called by the ExtractRowValues methods of
' GridView and DetailsView. Retrieve the current value of the 
' cell from the Checked state of the Radio button.
Public Overrides Sub ExtractValuesFromCell( _
    ByVal dictionary As IOrderedDictionary, _
    ByVal cell As DataControlFieldCell, _
    ByVal rowState As DataControlRowState, _
    ByVal includeReadOnly As Boolean)
    ' Determine whether the cell contain a RadioButton 
    ' in its Controls collection.
    If cell.Controls.Count > 0 Then
        Dim radio As RadioButton = CType(cell.Controls(0), RadioButton)

        Dim checkedValue As Object = Nothing
        If radio Is Nothing Then
            ' A RadioButton is expected, but a null is encountered.
            ' Add error handling.
            Throw New InvalidOperationException( _
                "RadioButtonField could not extract control.")
        Else
            checkedValue = radio.Checked
        End If


        ' Add the value of the Checked attribute of the
        ' RadioButton to the dictionary.
        If dictionary.Contains(DataField) Then
            dictionary(DataField) = checkedValue
        Else
            dictionary.Add(DataField, checkedValue)
        End If
    End If
End Sub

Commenti

Il ExtractValuesFromCell metodo viene implementato dai tipi derivati da DataControlField per associare il campo corrente a un valore, se applicabile. La coppia field/value viene archiviata nella dictionary raccolta passata al metodo. Il ExtractValuesFromCell metodo viene chiamato dal ExtractRowValues metodo dei controlli dati, DetailsView ad esempio e GridView.

Chiamare questo metodo quando si scrive un controllo associato a dati personalizzato che usa DataControlFieldCell oggetti per assemblare un set di celle e i relativi valori associati. Implementare questo metodo quando si scrive una classe derivata da DataControlField che visualizza i dati utente o i dati associati a dati. Non tutti i tipi derivati implementano il ExtractValuesFromCell metodo, perché non tutti i campi visualizzano i dati utente. Ad esempio, il ButtonField controllo visualizza un pulsante e non dispone di dati utente.

Si applica a

Vedi anche

• InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)