Control.DataBind Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak összes gyermekvezérlőihez köti.
Túlterhelések
| Név | Description |
|---|---|
| DataBind() |
Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak összes gyermekvezérlőihez köti. |
| DataBind(Boolean) |
Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak gyermekvezérlőihez köti, és lehetőséget ad az DataBinding esemény elindítására. |
DataBind()
Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak összes gyermekvezérlőihez köti.
public:
virtual void DataBind();
public virtual void DataBind();
abstract member DataBind : unit -> unit
override this.DataBind : unit -> unit
Public Overridable Sub DataBind ()
Példák
Az alábbi példa felülírja a DataBind metódust egy egyéni ASP.NET kiszolgálóvezérlőben. Először meghívja az alapmetódust OnDataBinding , majd a ControlCollection.Clear metódussal törli az összes gyermekvezérlőt, és a metódussal törli a ClearChildViewState gyermekvezérlők mentett nézetállapot-beállításait. Végül a ChildControlsCreated tulajdonság be van állítva true , és a vezérlőt arra utasítja, hogy kövesse nyomon az újonnan létrehozott vezérlők nézetállapotának változásait a TrackViewState metódussal. Ez egy gyakori módszer, amikor adatokat köt egy vezérlőhöz annak érdekében, hogy az új adatok ne ütközhessenek egy korábbi DataBind metódushívásból tárolt adatokkal.
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
Megjegyzések
Ezzel a módszerrel adatokat köthet egy forrásból egy kiszolgálóvezérlőhöz. Ezt a módszert gyakran használják az adathalmaz adatbázis-lekérdezésen keresztüli lekérése után. A legtöbb vezérlő automatikusan végez adatkötést, ami azt jelenti, hogy általában nem kell explicit módon meghívnia ezt a metódust.
Ezt a módszert általában felül kell bírálni egy egyéni sablonalapú adatkötésű vezérlő létrehozásakor. További információ: Hogyan is: Sablonalapú ASP.NET felhasználói vezérlők létrehozása és Az egyéni Data-Bound webkiszolgáló-vezérlők létrehozása. Kiszolgálóvezérlő meghívása esetén ez a metódus feloldja a kiszolgálóvezérlőben és annak gyermekvezérlőiben található összes adatkötési kifejezést.
Lásd még
- OnDataBinding(EventArgs)
- DataBinding
- DataBindChildren()
- A kiszolgálóvezérlők egyéni ASP.NET
- ASP.NET lap életciklusának áttekintése
A következőre érvényes:
DataBind(Boolean)
Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak gyermekvezérlőihez köti, és lehetőséget ad az DataBinding esemény elindítására.
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)
Paraméterek
- raiseOnDataBinding
- Boolean
trueha az DataBinding esemény fel van emelve; ellenkező esetben. false
Megjegyzések
Használja a Control.DataBind(Boolean) metódust egy olyan forgatókönyvben, amikor az egyéni vezérlő felülírja a DataBind metódust, és implementálja a IDataItemContainer felületet. Ebben a forgatókönyvben az egyéni vezérlő a beállítással Control.DataBind(Boolean)raiseOnDataBinding meghívja a false metódust, hogy biztosítsa az alaposztály metódusának meghívásátDataBind.
A Control.DataBind() metódus a következő beállítással Control.DataBind(Boolean) hívja meg a raiseOnDataBinding metódusttrue: .
Note
Ha a Control.DataBind(Boolean) metódust raiseOnDataBinding úgy hívja meg, hogy false a gyermekvezérlők a metódushoz Control.DataBind() vannak kötve.