Control.DataBind Método

Definição

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

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

Confira também

Aplica-se a