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