Freigeben über

IPostBackDataHandler-Schnittstelle

  • Artikel

Definiert Methoden, die von ASP.NET-Serversteuerelementen implementiert werden müssen, um Postbackdaten automatisch zu laden.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Interface IPostBackDataHandler
'Usage
Dim instance As IPostBackDataHandler

public interface IPostBackDataHandler

public interface class IPostBackDataHandler

public interface IPostBackDataHandler

public interface IPostBackDataHandler

Hinweise

Wenn ein Serversteuerelement erstellt wird, das vom Client an den Server zurückgesendete Formulardaten überprüfen soll, müssen Sie die IPostBackDataHandler-Schnittstelle implementieren. Mithilfe des von dieser Schnittstelle definierten Vertrags kann ein Serversteuerelement bestimmen, ob sein Zustand aufgrund der Postbackdaten geändert werden muss und ob die entsprechenden Ereignisse ausgelöst werden müssen. Weitere Informationen finden Sie unter Serverereignisbehandlung auf ASP.NET-Webseiten.

Beispiel

Im folgenden Codebeispiel wird ein benutzerdefiniertes Textfeld-Serversteuerelement veranschaulicht, das die IPostBackDataHandler-Schnittstelle implementiert. Die Text-Eigenschaft wird als Ergebnis des Postbackvorgangs geändert, und das Serversteuerelement löst nach dem Laden der Postbackdaten ein TextChanged-Ereignis aus.

Imports System
Imports System.Web
Imports System.Web.UI
Imports System.Collections
Imports System.Collections.Specialized

Namespace CustomWebFormsControls
    
    <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> Public Class MyTextBox
        Inherits Control
        Implements IPostBackDataHandler
        
        
        Public Property Text() As String
            Get
                Return CType(Me.ViewState("Text"), String)
            End Get
            
            Set
                Me.ViewState("Text") = value
            End Set
        End Property
        
        
        Public Event TextChanged As EventHandler
        
        
        Public Overridable Shadows Function LoadPostData( _
        postDataKey As String, _
        postCollection As System.Collections.Specialized.NameValueCollection) _
        As Boolean Implements IPostBackDataHandler.LoadPostData
            
            Dim presentValue As String = Text
            Dim postedValue As String = postCollection(postDataKey)
            
            If presentValue Is Nothing Or Not presentValue.Equals(postedValue) Then
                Text = postedValue
                Return True
            End If
            
            Return False
        End Function
        
        
        Public Overridable Shadows Sub RaisePostDataChangedEvent() _
        Implements IPostBackDataHandler.RaisePostDataChangedEvent
        
            OnTextChanged(EventArgs.Empty)
        End Sub
        
        
        Protected Overridable Sub OnTextChanged(e As EventArgs)
            RaiseEvent TextChanged(Me, e)
        End Sub
        
        
        Protected Overrides Sub Render(output As HtmlTextWriter)
            output.Write("<INPUT type= text name = " & Me.UniqueID & _
                " value = " & Me.Text & " >")
        End Sub
        
    End Class
    
End Namespace

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 + " >");
      }
   }   
}

.NET Framework-Sicherheit

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

IPostBackDataHandler-Member
System.Web.UI-Namespace

Weitere Ressourcen

Serverereignisbehandlung auf ASP.NET-Webseiten