IPostBackDataHandler Interfejs

Definicja

Definiuje metody, które ASP.NET kontrolki serwera muszą implementować w celu automatycznego ładowania danych po powrocie zwrotnych.

public interface IPostBackDataHandler
Pochodne

Przykłady

Poniższy przykład kodu przedstawia niestandardową kontrolkę serwera pól tekstowych, która implementuje IPostBackDataHandler interfejs. Właściwość Text jest zmieniana w wyniku powrotu po powrocie TextChanged , a kontrolka serwera zgłasza zdarzenie po załadowaniu danych zwrotnych.

using System;
using System.Web;
using System.Web.UI;
using System.Collections;
using System.Collections.Specialized;

namespace CustomWebFormsControls {

   [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
   public class MyTextBox: Control, IPostBackDataHandler {

      public String Text {
         get {
            return (String) ViewState["Text"];
         }

         set {
            ViewState["Text"] = value;
         }
      }

      public event EventHandler TextChanged;

      public virtual bool LoadPostData(string postDataKey,
         NameValueCollection postCollection) {

         String presentValue = Text;
         String postedValue = postCollection[postDataKey];

         if (presentValue == null || !presentValue.Equals(postedValue)) {
            Text = postedValue;
            return true;
         }

         return false;
      }

      public virtual void RaisePostDataChangedEvent() {
         OnTextChanged(EventArgs.Empty);
      }

      protected virtual void OnTextChanged(EventArgs e) {
         if (TextChanged != null)
            TextChanged(this,e);
      }

      protected override void Render(HtmlTextWriter output) {
         output.Write("<INPUT type= text name = "+this.UniqueID
            + " value = " + this.Text + " >");
      }
   }
}

Uwagi

Interfejs należy zaimplementować IPostBackDataHandler podczas tworzenia kontrolki serwera, która musi badać dane formularzy, które są publikowane z powrotem na serwerze przez klienta. Kontrakt definiowany przez ten interfejs umożliwia kontrolę serwera w celu określenia, czy jego stan powinien zostać zmieniony w wyniku powrotu po awarii, oraz do zgłaszania odpowiednich zdarzeń. Aby uzyskać więcej informacji, zobacz Server Event Handling in ASP.NET Web Forms Pages (Obsługa zdarzeń serwera na stronach ASP.NET formularzy sieci Web).

Metody

LoadPostData(String, NameValueCollection)

W przypadku zaimplementowania przez klasę przetwarzanie danych po powrocie do kontroli serwera ASP.NET.

RaisePostDataChangedEvent()

Po zaimplementowaniu przez klasę sygnalizuje kontrolę serwera, aby powiadomić aplikację ASP.NET o zmianie stanu kontrolki.

Dotyczy

Produkt Wersje
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Zobacz też