DataControlField.InitializeCell Método

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Adiciona texto ou controles à coleção de controles da célula.

public:
 virtual void InitializeCell(System::Web::UI::WebControls::DataControlFieldCell ^ cell, System::Web::UI::WebControls::DataControlCellType cellType, System::Web::UI::WebControls::DataControlRowState rowState, int rowIndex);

public virtual void InitializeCell (System.Web.UI.WebControls.DataControlFieldCell cell, System.Web.UI.WebControls.DataControlCellType cellType, System.Web.UI.WebControls.DataControlRowState rowState, int rowIndex);

abstract member InitializeCell : System.Web.UI.WebControls.DataControlFieldCell * System.Web.UI.WebControls.DataControlCellType * System.Web.UI.WebControls.DataControlRowState * int -> unit
override this.InitializeCell : System.Web.UI.WebControls.DataControlFieldCell * System.Web.UI.WebControls.DataControlCellType * System.Web.UI.WebControls.DataControlRowState * int -> unit

Public Overridable Sub InitializeCell (cell As DataControlFieldCell, cellType As DataControlCellType, rowState As DataControlRowState, rowIndex As Integer)

Parâmetros

cell: DataControlFieldCell

Um DataControlFieldCell que contém o texto ou os controles do DataControlField.

cellType: DataControlCellType

Um dos valores de DataControlCellType.

rowState: DataControlRowState

Um dos valores DataControlRowState, que especifica o estado da linha que contém a DataControlFieldCell.

rowIndex: Int32

O índice da linha em que o objeto DataControlFieldCell está contido.

Exemplos

O exemplo de código a seguir demonstra como implementar o InitializeCell método para um controle que deriva da DataControlField classe. A RadioButtonField classe renderiza um botão de opção associado a dados para cada linha em um GridView controle. Quando a linha está exibindo dados para um usuário e não está no modo de edição, o RadioButton controle é desabilitado. Quando a linha está no modo de edição, por exemplo, quando o usuário opta por atualizar uma linha no GridView controle, o RadioButton controle é renderizado como habilitado para que ele possa ser clicado. Este exemplo usa operadores AND bit a bit, pois o estado da linha pode ser uma combinação de um ou mais DataControlRowState valores.

// This method adds a RadioButton control and any other 
// content to the cell's Controls collection.
protected override void InitializeDataCell
    (DataControlFieldCell cell, DataControlRowState rowState) {

  RadioButton radio = new RadioButton();

  // If the RadioButton is bound to a DataField, add
  // the OnDataBindingField method event handler to the
  // DataBinding event.
  if (DataField.Length != 0) {
    radio.DataBinding += new EventHandler(this.OnDataBindField);
  }

  radio.Text = this.Text;

  // Because the RadioButtonField is a BoundField, it only
  // displays data. Therefore, unless the row is in edit mode,
  // the RadioButton is displayed as disabled.
  radio.Enabled = false;
  // If the row is in edit mode, enable the button.
  if ((rowState & DataControlRowState.Edit) != 0 ||
      (rowState & DataControlRowState.Insert) != 0) {
    radio.Enabled = true;
  }

  cell.Controls.Add(radio);
}

' This method adds a RadioButton control and any other 
' content to the cell's Controls collection.
Protected Overrides Sub InitializeDataCell( _
    ByVal cell As DataControlFieldCell, _
    ByVal rowState As DataControlRowState)

    Dim radio As New RadioButton()

    ' If the RadioButton is bound to a DataField, add
    ' the OnDataBindingField method event handler to the
    ' DataBinding event.
    If DataField.Length <> 0 Then
        AddHandler radio.DataBinding, AddressOf Me.OnDataBindField
    End If

    radio.Text = Me.Text

    ' Because the RadioButtonField is a BoundField, it only 
    ' displays data. Therefore, unless the row is in edit mode, 
    ' the RadioButton is displayed as disabled.
    radio.Enabled = False
    ' If the row is in edit mode, enable the button.
    If (rowState And DataControlRowState.Edit) <> 0 _
        OrElse (rowState And DataControlRowState.Insert) <> 0 Then
        radio.Enabled = True
    End If

    cell.Controls.Add(radio)
End Sub

Comentários

Tipos derivados da implementação do DataControlField InitializeCell método para adicionar texto e controles a um DataControlFieldCell objeto que pertence a um controle de dados que usa tabelas para exibir uma interface do usuário (interface do usuário). Esses controles de dados criam a linha completa da estrutura da tabela por linha quando seus respectivos CreateChildControls métodos são chamados. O InitializeCell método é chamado pelo InitializeRow método de controles de dados, como DetailsView e GridView.

Chame esse método quando você estiver escrevendo um controle personalizado associado a dados que usa DataControlFieldCell objetos para inicializar as células da estrutura da tabela com dados ou controles. Implemente esse método quando você estiver escrevendo uma classe derivada de DataControlField.

Aplica-se a

Confira também

ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Compartilhar via