チェンジセット 1635 (default)

日時:

2024/02/13 1:10:48 (8ヵ月前)

更新者:

hizuya@…

ログメッセージ:

• FileUpload コントロールに AutoPostBack の機能を追加。

場所:

framework/trunk

ファイル:

• WebApplication/UI/WebControls/FileUploadPage.aspx (追加)
• WebApplication/UI/WebControls/FileUploadPage.aspx.cs (追加)
• WebApplication/UI/WebControls/FileUploadPage.aspx.designer.cs (追加)
• WebApplication/WebApplication.csproj (更新) (2個の差分)
• WebLibrary/Sources/UI/ClientScriptUtility.cs (更新) (2個の差分)
• WebLibrary/Sources/UI/WebControls/FileUpload.cs (更新) (3個の差分)

framework/trunk/WebApplication/WebApplication.csproj

@@ -69 +69 @@
     <Content Include="UI\WebControls\CompareValidatorPage.aspx" />
     <Content Include="UI\WebControls\ControlPropertyLinkageConnectorPage.aspx" />
+    <Content Include="UI\WebControls\FileUploadPage.aspx" />
     <Content Include="UI\WebControls\FormViewBindUserControl1.ascx" />
     <Content Include="UI\WebControls\FormViewPage.aspx" />
@@ -298 +299 @@
     <Compile Include="UI\WebControls\DialogPage.aspx.designer.cs">
       <DependentUpon>DialogPage.aspx</DependentUpon>
+    </Compile>
+    <Compile Include="UI\WebControls\FileUploadPage.aspx.cs">
+      <DependentUpon>FileUploadPage.aspx</DependentUpon>
+      <SubType>ASPXCodeBehind</SubType>
+    </Compile>
+    <Compile Include="UI\WebControls\FileUploadPage.aspx.designer.cs">
+      <DependentUpon>FileUploadPage.aspx</DependentUpon>
     </Compile>
     <Compile Include="UI\WebControls\FormViewBindUserControl1.ascx.cs">

framework/trunk/WebLibrary/Sources/UI/ClientScriptUtility.cs

@@ -554 +554 @@
 
         /// <summary>
-        /// WebForm 用のスクリプトを登録します。
+        /// クライアントスクリプトからポストバック可能にするスクリプトを登録します。
         /// </summary>
         /// <param name="page">
@@ -565 +565 @@
 
         /// <summary>
-        /// WebForm 用のスクリプトを登録します。
+        /// フォーカスを制御するスクリプトを登録します。
         /// </summary>
         /// <param name="page">

framework/trunk/WebLibrary/Sources/UI/WebControls/FileUpload.cs

@@ -23 +23 @@
 namespace FCSoft.SilverFrost.Framework.Web.UI.WebControls
 {
+    using System;
+    using System.Collections.Specialized;
+    using System.ComponentModel;
+    using System.Web;
+    using System.Web.UI;
+
+
     /// <summary>
     /// ユーザーがファイルを選択してサーバーにアップロードするための
@@ -29 +36 @@
     [WebDescription("Description_FileUpload")]
     [ControlInitializerTarget]
+    [SupportsEventValidation]
     public class FileUpload :
-        System.Web.UI.WebControls.FileUpload
+        System.Web.UI.WebControls.FileUpload,
+        IPostBackDataHandler
     {
         /// <summary>
+        /// <see cref="AutoPostBack"/> プロパティ用のキー。
+        /// </summary>
+        private const string AutoPostBackKey = "AutoPostBack";
+
+        /// <summary>
+        /// <see cref="CausesValidation"/> プロパティ用のキー。
+        /// </summary>
+        private const string CausesValidationKey = "CausesValidation";
+
+        /// <summary>
+        /// <see cref="ValidationGroup"/> プロパティ用のキー。
+        /// </summary>
+        private const string ValidationGroupKey = "ValidationGroup";
+
+
+        /// <summary>
+        /// <see cref="FileSelected"/> イベントハンドラの識別子。
+        /// </summary>
+        private static readonly object EventFileSelectedKey = new object();
+
+
+        /// <summary>
         /// インスタンスを作成します。
         /// </summary>
@@ -38 +69 @@
         {
             ControlInitializer.ApplyProperties(this);
+        }
+
+
+        /// <summary>
+        /// ファイルが選択されサーバーへのポスト間で変更された場合に発生します。
+        /// </summary>
+        [WebCategory("Action")]
+        [WebDescription("Description_FileSelected")]
+        public event EventHandler FileSelected
+        {
+            add
+            {
+                Events.AddHandler(EventFileSelectedKey, value);
+            }
+
+            remove
+            {
+                Events.RemoveHandler(EventFileSelectedKey, value);
+            }
+        }
+
+
+        /// <summary>
+        /// <see cref="FileUpload"/> コントロールがフォーカスを失ったときに、
+        /// サーバーへの自動ポストバックが発生するかどうかを示す値を取得または設定します。
+        /// </summary>
+        /// <value>
+        /// サーバーへの自動ポストバックが発生する場合は <see langword="true"/>。
+        /// それ以外の場合は <see langword="false"/>。
+        /// </value>
+        [DefaultValue(false)]
+        [Themeable(false)]
+        [WebCategory("Behavior")]
+        [WebDescription("Description_AutoPostBack")]
+        public virtual bool AutoPostBack
+        {
+            get
+            {
+                return (bool)(ViewState[AutoPostBackKey] ?? false);
+            }
+
+            set
+            {
+                ViewState[AutoPostBackKey] = value;
+            }
+        }
+
+        /// <summary>
+        /// <see cref="FileUpload"/> コントロールによりポストバックされたときに
+        /// 検証を実行するかどうかを示す値を取得または設定します。
+        /// </summary>
+        /// <value>
+        /// <see cref="FileUpload"/> コントロールによりポストバックされたときに
+        /// 検証を実行する場合は <see langword="true"/>。
+        /// それ以外の場合は <see langword="false"/>。
+        /// 既定値は <see langword="true"/> です。
+        /// </value>
+        [Themeable(false)]
+        [DefaultValue(true)]
+        [WebCategory("Behavior")]
+        [WebDescription("Description_CausesValidation")]
+        public virtual bool CausesValidation
+        {
+            get
+            {
+                return (bool)(ViewState[CausesValidationKey] ?? true);
+            }
+
+            set
+            {
+                ViewState[CausesValidationKey] = value;
+            }
+        }
+
+        /// <summary>
+        /// サーバーへのポストバック時に、<see cref="FileUpload"/> コントロールによって発生する
+        /// 検証の対象となるコントロールのグループを取得または設定します。
+        /// </summary>
+        /// <value>
+        /// サーバーへのポストバック時に、<see cref="FileUpload"/> コントロールによって発生する
+        /// 検証の対象となるコントロールのグループ。
+        /// 既定値は空の文字列 ("") です。
+        /// </value>
+        [Themeable(false)]
+        [DefaultValue("")]
+        [WebCategory("Behavior")]
+        [WebDescription("Description_ValidationGroup")]
+        public virtual string ValidationGroup
+        {
+            get
+            {
+                return (string)(ViewState[ValidationGroupKey] ?? string.Empty);
+            }
+
+            set
+            {
+                ViewState[ValidationGroupKey] = value;
+            }
+        }
+
+
+        #region IPostBackDataHandler メンバ
+
+        /// <summary>
+        /// コントロールのポストバック データを処理します。
+        /// </summary>
+        /// <param name="postDataKey">
+        /// コントロールのキー識別子。
+        /// </param>
+        /// <param name="postCollection">
+        /// 受信する名前と値すべてのコレクション。
+        /// </param>
+        /// <returns>
+        /// ポストバックの結果、サーバー コントロールの状態が変化する場合は <see langword="true"/>。
+        /// それ以外の場合は <see langword="false"/>。
+        /// </returns>
+        bool IPostBackDataHandler.LoadPostData(string postDataKey, NameValueCollection postCollection)
+        {
+            return LoadPostData(postDataKey, postCollection);
+        }
+
+        /// <summary>
+        /// コントロールの状態が変化したことを ASP.NET アプリケーションに通知するために、
+        /// サーバー コントロールにシグナルを送信します。
+        /// </summary>
+        void IPostBackDataHandler.RaisePostDataChangedEvent()
+        {
+            RaisePostDataChangedEvent();
+        }
+
+        #endregion
+
+        /// <summary>
+        /// コントロールのポストバック データを処理します。
+        /// </summary>
+        /// <param name="postDataKey">
+        /// コントロールのキー識別子。
+        /// </param>
+        /// <param name="postCollection">
+        /// 受信する名前と値すべてのコレクション。
+        /// </param>
+        /// <returns>
+        /// ポストバックの結果、サーバー コントロールの状態が変化する場合は <see langword="true"/>。
+        /// それ以外の場合は <see langword="false"/>。
+        /// </returns>
+        protected virtual bool LoadPostData(string postDataKey, NameValueCollection postCollection)
+        {
+            if (Page != null)
+            {
+                Page.ClientScript.ValidateEvent(postDataKey, string.Empty);
+            }
+
+            // ファイルがポストされていれば true を返す
+            HttpPostedFile postedFile = PostedFile;
+            return postedFile != null
+                && (!string.IsNullOrEmpty(postedFile.FileName) || postedFile.ContentLength > 0);
+        }
+
+        /// <summary>
+        /// コントロールの状態が変化したことを ASP.NET アプリケーションに通知するために、
+        /// サーバー コントロールにシグナルを送信します。
+        /// </summary>
+        protected virtual void RaisePostDataChangedEvent()
+        {
+            if (AutoPostBack && !Page.IsPostBackEventControlRegistered)
+            {
+                Page.AutoPostBackControl = this;
+
+                if (CausesValidation)
+                {
+                    Page.Validate(ValidationGroup);
+                }
+            }
+
+            OnFileSelected(EventArgs.Empty);
+        }
+
+        /// <summary>
+        /// <see cref="FileSelected"/> イベントを発生させます。
+        /// </summary>
+        /// <param name="e">
+        /// イベント データを格納している <see cref="EventArgs"/>。
+        /// </param>
+        protected virtual void OnFileSelected(EventArgs e)
+        {
+            EventHandler textChangedHandler = (EventHandler)Events[EventFileSelectedKey];
+            if (textChangedHandler != null)
+            {
+                textChangedHandler(this, e);
+            }
+        }
+
+        /// <summary>
+        /// このコントロールがレンダリングされる直前に呼び出されるイベントハンドラです。
+        /// </summary>
+        /// <param name="e">
+        /// イベント データを格納している <see cref="EventArgs"/>。
+        /// </param>
+        protected override void OnPreRender(EventArgs e)
+        {
+            // 親を呼び出す
+            base.OnPreRender(e);
+
+            Page page = Page;
+            if (page == null)
+            {
+                return;
+            }
+
+            bool enabled = IsEnabled;
+
+            if (enabled)
+            {
+                // ReSharper disable once ExceptionNotDocumented
+                page.RegisterRequiresPostBack(this);
+
+                if (AutoPostBack)
+                {
+                    ClientScriptUtility.RegisterPostBackScript(page);
+                    ClientScriptUtility.RegisterFocusScript(page);
+
+                    // バリデーションを行う場合
+                    if (CausesValidation && page.GetValidators(ValidationGroup).Count > 0)
+                    {
+                        ClientScriptUtility.RegisterWebFormsScript(page);
+                    }
+                }
+            }
+        }
+
+        /// <summary>
+        /// 指定した <see cref="HtmlTextWriter"/> に表示する必要のある HTML 属性およびスタイルを追加します。
+        /// </summary>
+        /// <param name="writer">
+        /// クライアントに HTML のコンテンツを表示する出力ストリーム。
+        /// </param>
+        /// <exception cref="HttpException">
+        /// 実行時に、指定されたサーバー コントロールが <see cref="T:System.Web.UI.HtmlControls.HtmlForm" />
+        /// サーバー コントロールの開始タグと終了タグの間に含まれていません。
+        /// </exception>
+        protected override void AddAttributesToRender(HtmlTextWriter writer)
+        {
+            Page page = Page;
+            if (page != null)
+            {
+                page.VerifyRenderingInServerForm(this);
+            }
+
+            if (page != null)
+            {
+                if (AutoPostBack)
+                {
+                    string onChange = null;
+                    if (HasAttributes)
+                    {
+                        onChange = Attributes["onchange"];
+                        if (onChange != null)
+                        {
+                            onChange = ClientScriptUtility.EnsureEndWithSemiColon(onChange);
+                            Attributes.Remove("onchange");
+                        }
+                    }
+
+                    PostBackOptions options = new PostBackOptions(this, string.Empty);
+                    if (CausesValidation)
+                    {
+                        options.PerformValidation = true;
+                        options.ValidationGroup = ValidationGroup;
+                    }
+
+                    if (page.Form != null)
+                    {
+                        options.AutoPostBack = true;
+                    }
+
+                    writer.AddAttribute(
+                        HtmlTextWriterAttribute.Onchange,
+                        ClientScriptUtility.MergeScript(onChange, page.ClientScript.GetPostBackEventReference(options, true), false));
+                }
+                else
+                {
+                    page.ClientScript.RegisterForEventValidation(UniqueID, string.Empty);
+                }
+            }
+
+            if (Enabled && !IsEnabled && SupportsDisabledAttribute)
+            {
+                writer.AddAttribute(HtmlTextWriterAttribute.Disabled, "disabled");
+            }
+
+            // 親を呼び出す
+            base.AddAttributesToRender(writer);
         }
     }