IPostBackDataHandler インターフェイスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

IPostBackDataHandler インターフェイス

ポストバックデータを自動的に読み込むために ASP.NET サーバーコントロールで実装する必要があるメソッドを定義します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Interface IPostBackDataHandler

Visual Basic (使用法)

Dim instance As IPostBackDataHandler

public interface IPostBackDataHandler

C++

public interface class IPostBackDataHandler

public interface IPostBackDataHandler

JScript

public interface IPostBackDataHandler

解説

クライアントからサーバーにポストバックされるフォームデータを調べる必要があるサーバーコントロールを作成する場合、IPostBackDataHandler インターフェイスを実装する必要があります。このインターフェイスが定義しているコントラクトによって、サーバーコントロール側で、ポストバックの結果、コントロールの状態を変更する必要があるかどうかを判断し、適切なイベントを発生させることができます。詳細については、「ASP.NET Web ページのサーバーイベント処理」を参照してください。

使用例

IPostBackDataHandler インターフェイスを実装するカスタムテキストボックスサーバーコントロールのコード例を次に示します。ポストバックの結果、Text プロパティが変更され、サーバーコントロールは、ポストバックデータが読み込まれた後に TextChanged イベントを発生させます。

Visual Basic

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