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 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 modelos. 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

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

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 truecomo raiseOnDataBinding .

Confira também

• DataBinding
• DataBindChildren()
• Visão geral do ciclo de vida da página ASP.NET