asp.net 学习

  // 摘要:
    //     显示一个文本框控件和一个浏览按钮，使用户可以选择要上载到服务器的文件。
    [ControlValueProperty("FileBytes")]
    [ValidationProperty("FileName")]
    [Designer("System.Web.UI.Design.WebControls.PreviewControlDesigner, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
    public class FileUpload : WebControl
    {
        // 摘要:
        //     初始化 System.Web.UI.WebControls.FileUpload 类的新实例。
        public FileUpload();

        // 摘要:
        //     从使用 System.Web.UI.WebControls.FileUpload 控件指定的文件中获取一个字节数组。
        //
        // 返回结果:
        //     System.Byte 数组，包含指定文件的内容。
        //
        // 异常:
        //   System.Web.HttpException:
        //     未读取整个文件。
        [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
        [Browsable(false)]
        [Bindable(true)]
        public byte[] FileBytes { get; }
        //
        // 摘要:
        //     获取 System.IO.Stream 对象，它指向要使用 System.Web.UI.WebControls.FileUpload 控件上载的文件。
        //
        // 返回结果:
        //     System.IO.Stream，指向使用 System.Web.UI.WebControls.FileUpload 上载的文件。
        [Browsable(false)]
        [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
        public Stream FileContent { get; }
        //
        // 摘要:
        //     获取客户端上使用 System.Web.UI.WebControls.FileUpload 控件上载的文件的名称。
        //
        // 返回结果:
        //     该字符串指定客户端上使用 System.Web.UI.WebControls.FileUpload 上载的文件的名称。
        [Browsable(false)]
        [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
        public string FileName { get; }
        //
        // 摘要:
        //     获取一个值，该值指示 System.Web.UI.WebControls.FileUpload 控件是否包含文件。
        //
        // 返回结果:
        //     如果 System.Web.UI.WebControls.FileUpload 包含文件，则为 true；否则为 false。
        [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
        [Browsable(false)]
        public bool HasFile { get; }
        //
        // 摘要:
        //     获取使用 System.Web.UI.WebControls.FileUpload 控件上载的文件的基础 System.Web.HttpPostedFile
        //     对象。
        //
        // 返回结果:
        //     使用 System.Web.UI.WebControls.FileUpload 上载的文件的 System.Web.HttpPostedFile。
        [Browsable(false)]
        [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
        public HttpPostedFile PostedFile { get; }

        // 摘要:
        //     为指定的 System.Web.UI.HtmlTextWriter 对象添加 System.Web.UI.WebControls.FileUpload
        //     控件的 HTML 属性和样式，以在呈现内容时使用它们。
        //
        // 参数:
        //   writer:
        //     System.Web.UI.HtmlTextWriter，表示要在客户端呈现 HTML 内容的输出流。
        protected override void AddAttributesToRender(HtmlTextWriter writer);
        //
        // 摘要:
        //     为 System.Web.UI.WebControls.FileUpload 控件引发 System.Web.UI.Control.PreRender
        //     事件。
        //
        // 参数:
        //   e:
        //     包含事件数据的 System.EventArgs 对象。
        protected internal override void OnPreRender(EventArgs e);
        //
        // 摘要:
        //     将 System.Web.UI.WebControls.FileUpload 控件内容发送到指定的 System.Web.UI.HtmlTextWriter
        //     对象，该对象写入在客户端上呈现的内容。
        //
        // 参数:
        //   writer:
        //     接收 System.Web.UI.WebControls.FileUpload 控件内容的 System.Web.UI.HtmlTextWriter
        //     对象。
        protected internal override void Render(HtmlTextWriter writer);
        //
        // 摘要:
        //     将上载文件的内容保存到 Web 服务器上的指定路径。
        //
        // 参数:
        //   filename:
        //     一个字符串，指定服务器上用于保存上载文件的位置的完整路径。
        //
        // 异常:
        //   System.Web.HttpException:
        //     filename 不是完整路径。
        public void SaveAs(string filename);
    }