Udostępnij za pośrednictwem

Control.DataBind Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi jej kontrolkami podrzędnymi.

Przeciążenia

DataBind()

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi jej kontrolkami podrzędnymi.
DataBind(Boolean)

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją wywołania DataBinding zdarzenia.

DataBind()

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi jej kontrolkami podrzędnymi.

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

Przykłady

Poniższy przykład zastępuje metodę DataBind w niestandardowej kontroli serwera ASP.NET. Rozpoczyna się od wywołania metody podstawowej OnDataBinding , a następnie używa ControlCollection.Clear metody do usunięcia wszystkich kontrolek podrzędnych i ClearChildViewState metody w celu usunięcia wszystkich zapisanych ustawień stanu widoku dla tych kontrolek podrzędnych. ChildControlsCreated Na koniec właściwość jest ustawiona true na , a kontrolka jest poinstruowana, aby śledzić wszelkie zmiany stanu widoku nowo utworzonych kontrolek za TrackViewState pomocą metody . Jest to powszechna technika powiązania danych z kontrolką w celu zapewnienia, że nowe dane nie powodują konfliktu z danymi przechowywanymi z poprzedniego DataBind wywołania 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

Uwagi

Ta metoda umożliwia powiązanie danych ze źródła z kontrolką serwera. Ta metoda jest często używana po pobraniu zestawu danych za pomocą zapytania bazy danych. Większość kontrolek automatycznie wykonuje powiązanie danych, co oznacza, że zwykle nie trzeba jawnie wywoływać tej metody.

Ta metoda jest często zastępowana podczas tworzenia niestandardowej kontrolki powiązanej z danymi szablonu. Aby uzyskać więcej informacji, zobacz How to: Create Templated ASP.NET User Controls and Developing Custom Data-Bound Web Server Controls (Jak utworzyć szablonowe kontrolki ASP.NET użytkownika) i Developing Custom Data-Bound Web Server Controls (Tworzenie niestandardowych kontrolek serwera sieci Web Data-Bound). Po wywołaniu kontrolki serwera ta metoda rozpoznaje wszystkie wyrażenia powiązania danych w kontrolce serwera i w dowolnej z jego kontrolek podrzędnych.

Zobacz też

Dotyczy

DataBind(Boolean)

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją wywołania DataBinding zdarzenia.

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 jeśli zdarzenie jest zgłaszane; w przeciwnym razie . false

Uwagi

Użyj metody w scenariuszu Control.DataBind(Boolean) , gdy kontrolka niestandardowa zastępuje metodę DataBind i implementuje IDataItemContainer interfejs. W tym scenariuszu kontrolka niestandardowa wywołuje metodę Control.DataBind(Boolean) z ustawioną wartością raiseOnDataBinding , aby false upewnić się, że metoda klasy bazowej DataBind zostanie wywołana.

Metoda Control.DataBind() wywołuje metodę Control.DataBind(Boolean) z ustawioną wartością trueraiseOnDataBinding .

Uwaga

Wywołanie metody z raiseOnDataBinding ustawieniem Control.DataBind(Boolean) powoduje, że false wszystkie kontrolki podrzędne muszą być danymi powiązanymi z Control.DataBind() metodą .

Zobacz też

Dotyczy