Control.DataBind Metoda

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 odstraní všechna uložená 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 . Jedná se o běžnou techniku při vytváření vazby 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 tuto metodu obvykle není nutné volat 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 naleznete v tématu Postupy: Vytváření uživatelských ovládacích prvků ASP.NET šablony a Vývoj vlastních ovládacích prvků webového serveru Data-Bound. Při zavolání na serverovém ovládacím prvku tato metoda přeloží všechny výrazy vazby dat v serverovém ovládacím prvku 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
• ASP.NET přehled životního cyklu stránky

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

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

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

Viz také

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