Sdílet prostřednictvím

Control.DataBind Metoda

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.dll

Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky.

Přetížení

Name Description
DataBind()

Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky.
DataBind(Boolean)

Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost.

DataBind()

Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky.

public:
 virtual void DataBind();
public virtual void DataBind();
abstract member DataBind : unit -> unit
override this.DataBind : unit -> unit
Public Overridable Sub DataBind ()

Příklady

Následující příklad přepíše metodu DataBind ve vlastním ovládacím prvku serveru ASP.NET. Začíná voláním základní OnDataBinding metody a pak pomocí ControlCollection.Clear metody odstraní všechny podřízené ovládací prvky a metodu ClearChildViewState k odstranění všech uložených nastavení stavu zobrazení pro tyto podřízené ovládací prvky. ChildControlsCreated Nakonec je vlastnost nastavena true a ovládací prvek je instruován ke sledování všech změn stavu zobrazení nově vytvořených ovládacích prvků pomocí TrackViewState metody. Toto je běžná technika při vazbě dat k ovládacímu prvku, aby se zajistilo, že nová data nebudou v konfliktu s daty uloženými z předchozího DataBind volání metody.

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

Poznámky

Tato metoda slouží k vytvoření vazby dat ze zdroje na serverový ovládací prvek. Tato metoda se běžně používá po načtení datové sady prostřednictvím databázového dotazu. Většina ovládacích prvků provádí datové vazby automaticky, což znamená, že obvykle není nutné tuto metodu volat explicitně.

Tato metoda se obvykle přepisuje při vytváření vlastního ovládacího prvku vázaného na data šablony. Další informace naleznete v tématu Postupy: Vytvoření šablony ASP.NET uživatelských ovládacích prvků a vývoj vlastních ovládacích prvků Data-Bound webového serveru. Při zavolání na serverový ovládací prvek tato metoda vyřeší všechny výrazy datové vazby v ovládacím prvku serveru a ve všech jeho podřízených ovládacích prvcích.

Viz také

Platí pro

DataBind(Boolean)

Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost.

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)

Parametry

raiseOnDataBinding
Boolean

true je-li DataBinding událost vyvolána; v opačném případě false.

Poznámky

Tuto metodu Control.DataBind(Boolean) použijte ve scénáři, kdy vlastní ovládací prvek přepíše metodu DataBind a implementuje IDataItemContainer rozhraní. V tomto scénáři vlastní ovládací prvek volá metodu Control.DataBind(Boolean) s nastavenou raiseOnDataBinding tak, aby false se zajistilo, že se volá metoda základní třídy DataBind .

Metoda Control.DataBind() vyvolá metodu Control.DataBind(Boolean) s raiseOnDataBinding nastavenou hodnotou true.

Poznámka:

Control.DataBind(Boolean) Volání metody se raiseOnDataBinding sadou způsobí, že false všechny podřízené ovládací prvky budou svázané s metodouControl.DataBind().

Viz také

Platí pro