Control.DataBind Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

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

Przeciążenia

DataBind()	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi kontrolkami podrzędnymi.
DataBind(Boolean)	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją zgłaszania zdarzenia DataBinding .

DataBind()

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi 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żyje ControlCollection.Clear metody , aby usunąć wszystkie kontrolki podrzędne i ClearChildViewState metodę w celu usunięcia wszystkich zapisanych ustawień stanu widoku dla tych kontrolek podrzędnych. ChildControlsCreated Na koniec właściwość jest ustawiona na true , a kontrolka jest poinstruowana, aby śledzić wszelkie zmiany stanu widoku nowo utworzonych kontrolek za pomocą TrackViewState 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

Użyj tej metody, aby powiązać dane ze źródła do kontrolki serwera. Ta metoda jest często używana po pobraniu zestawu danych za pośrednictwem 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 szablonami danych. Aby uzyskać więcej informacji, zobacz How to: Create Templated ASP.NET User Controls and Developing Custom Data-Bound Web Server Controls (Tworzenie szablonowych kontrolek ASP.NET użytkownika i tworzenie niestandardowych kontrolek serwera sieci Web Data-Bound Web Server). 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ż

• OnDataBinding(EventArgs)
• DataBinding
• DataBindChildren()
• Tworzenie niestandardowych kontrolek serwera ASP.NET
• Przegląd cyklu życia strony ASP.NET

DataBind(Boolean)

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

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

trueDataBinding jeśli zdarzenie jest zgłaszane; w przeciwnym razie false.

Uwagi

Control.DataBind(Boolean) Użyj metody w scenariuszu, gdy kontrolka niestandardowa zastępuje DataBind metodę 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 DataBind bazowej zostanie wywołana.

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

Uwaga

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

Zobacz też

• DataBinding
• DataBindChildren()
• Przegląd cyklu życia strony ASP.NET