Control.DataBind Método

public:
 virtual void DataBind();

public virtual void DataBind();

abstract member DataBind : unit -> unit
override this.DataBind : unit -> unit

Public Overridable Sub DataBind ()

Exemplos

O exemplo seguinte sobrepõe o método DataBind num controlo personalizado ASP.NET servidor. Começa por chamar o método base OnDataBinding e depois usa o ControlCollection.Clear método para eliminar todos os controlos filhos e o ClearChildViewState método para eliminar quaisquer definições de estado de visualização guardadas para esses controlos filhos. Finalmente, a ChildControlsCreated propriedade é definida para true e o controlo é instruído a acompanhar quaisquer alterações no estado de vista dos controlos recém-criados com o TrackViewState método. Esta é uma técnica comum ao ligar dados a um controlo para garantir que novos dados não entram em conflito com dados armazenados de uma chamada de método anterior DataBind .

public override void DataBind() 
{
   base.OnDataBinding(EventArgs.Empty);
   // Reset the control's state.
   Controls.Clear();
   // Check for HasChildViewState to avoid unnecessary calls to ClearChildViewState.
   if (HasChildViewState)
      ClearChildViewState();
   ChildControlsCreated = true;
   if (!IsTrackingViewState)
      TrackViewState();
}

Public Overrides Sub DataBind()
   MyBase.OnDataBinding(EventArgs.Empty)
   ' Reset the control's state.
   Controls.Clear()
   ' Check for HasChildViewState to avoid unnecessary calls to ClearChildViewState.
   If HasChildViewState Then
      ClearChildViewState()
   End If
   ChildControlsCreated = True
   If Not IsTrackingViewState Then
      TrackViewState()
   End If
End Sub

Observações

Use este método para vincular dados de uma fonte a um controlo de servidor. Este método é frequentemente utilizado após a obtenção de um conjunto de dados através de uma consulta à base de dados. A maioria dos controlos realiza ligação automática de dados, o que significa que normalmente não precisa de chamar este método explicitamente.

Este método é frequentemente ultrapassado quando se cria um controlo personalizado com templates vinculados a dados. Para mais informações, consulte Como: Criar Controlos de Utilizador de ASP.NET Templated e Desenvolvimento de Controlos de Servidor Web Data-Bound Personalizados. Quando chamado a um controlo de servidor, este método resolve todas as expressões de ligação de dados no controlo do servidor e em qualquer um dos seus controlos filhos.

Ver também

• OnDataBinding(EventArgs)
• DataBinding
• DataBindChildren()
• Desenvolvimento de Controlos de Servidor ASP.NET Personalizados
• ASP.NET Visão Geral do Ciclo de Vida da Página

protected:
 virtual void DataBind(bool raiseOnDataBinding);

protected virtual void DataBind(bool raiseOnDataBinding);

abstract member DataBind : bool -> unit
override this.DataBind : bool -> unit

Protected Overridable Sub DataBind (raiseOnDataBinding As Boolean)

Parâmetros

Observações

Usa o Control.DataBind(Boolean) método num cenário em que o teu controlo personalizado sobrepõe o DataBind método e implementa a IDataItemContainer interface. Neste cenário, o controlo personalizado chama o Control.DataBind(Boolean) método com raiseOnDataBinding set to false para garantir que o método da DataBind classe base seja chamado.

O Control.DataBind() método invoca o Control.DataBind(Boolean) método com raiseOnDataBinding o conjunto de true.

Ver também

• DataBinding
• DataBindChildren()
• ASP.NET Visão Geral do Ciclo de Vida da Página