Control.DataBind Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

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

Přetížení

DataBind()	Vytvoří vazbu zdroje dat na vyvoláný serverový ovládací prvek a všechny jeho podřízené ovládací prvky.
DataBind(Boolean)	Vytvoří vazbu zdroje dat na vyvoláný 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 vyvoláný serverový ovládací prvek 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 ASP.NET serverovém ovládacím prvku. 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 na 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é volat tuto metodu explicitně.

Tato metoda se běžně přepisuje při vytváření vlastního ovládacího prvku vázaného na data v šabloně. Další informace najdete v tématech Postupy: Vytváření uživatelských ovládacích prvků ASP.NET šablon a vývoj vlastních ovládacích prvků webového serveru Data-Bound. Při vyvolání na serverovém ovládacím prvku tato metoda přeloží všechny výrazy datové vazby v ovládacím prvku serveru a v některém z jeho podřízených ovládacích prvků.

Viz také

• OnDataBinding(EventArgs)
• DataBinding
• DataBindChildren()
• Vývoj vlastních serverových ovládacích prvků ASP.NET
• přehled životního cyklu stránky ASP.NET

DataBind(Boolean)

Vytvoří vazbu zdroje dat na vyvoláný 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 DataBinding pokud je událost vyvolána, v opačném případě false.

Poznámky

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 volá vlastní ovládací prvek metodu Control.DataBind(Boolean) s nastavenou raiseOnDataBinding na false , aby se zajistilo, že se volá metoda základní třídy DataBind .

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

Poznámka

Control.DataBind(Boolean) Volání metody s nastavenou raiseOnDataBinding způsobífalse, že všechny podřízené ovládací prvky budou vázány na data s metodouControl.DataBind().

Viz také

• DataBinding
• DataBindChildren()
• přehled životního cyklu stránky ASP.NET