Control.DataBind Método
Definição
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.
Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho.
Sobrecargas
DataBind() |
Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho. |
DataBind(Boolean) |
Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding. |
DataBind()
Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho.
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 a seguir substitui o DataBind método em um controle de servidor ASP.NET personalizado. Ele começa chamando o método base OnDataBinding e, em seguida, usa o ControlCollection.Clear método para excluir todos os controles filho e o ClearChildViewState método para excluir quaisquer configurações de estado de exibição salvas para esses controles filho. Por fim, a ChildControlsCreated propriedade é definida true
como e o controle é instruído a controlar quaisquer alterações no estado de exibição dos controles recém-criados com o TrackViewState método . Essa é uma técnica comum ao associar dados a um controle para garantir que novos dados não entrem em conflito com os 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
Comentários
Use esse método para associar dados de uma origem a um controle de servidor. Esse método é comumente usado depois de recuperar um conjunto de dados por meio de uma consulta de banco de dados. A maioria dos controles executa a associação de dados automaticamente, o que significa que você normalmente não precisa chamar esse método explicitamente.
Esse método geralmente é substituído quando você cria um controle personalizado associado a dados com modelo. Para obter mais informações, consulte How to: Create Templated ASP.NET User Controls and Developing Custom Data-Bound Web Server Controls. Quando chamado em um controle de servidor, esse método resolve todas as expressões de associação de dados no controle do servidor e em qualquer um de seus controles filho.
Confira também
- OnDataBinding(EventArgs)
- DataBinding
- DataBindChildren()
- Desenvolvendo controles de servidores ASP.NET personalizados
- Visão geral do ciclo de vida da página ASP.NET
Aplica-se a
DataBind(Boolean)
Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding.
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
- raiseOnDataBinding
- Boolean
true
se o evento DataBinding for gerado; caso contrário, false
.
Comentários
Use o Control.DataBind(Boolean) método em um cenário quando o controle personalizado substituir o DataBind método e implementar a IDataItemContainer interface . Nesse cenário, o controle personalizado chama o Control.DataBind(Boolean) método com raiseOnDataBinding
definido como para false
garantir que o método da DataBind classe base seja chamado.
O Control.DataBind() método invoca o Control.DataBind(Boolean) método com definido true
como raiseOnDataBinding
.
Observação
Chamar o Control.DataBind(Boolean) método com definido como false
faz com raiseOnDataBinding
que todos os controles filho sejam associados a dados com o Control.DataBind() método .