共用方式為


如何:使用 Windows Form RichTextBox 控制項儲存檔案

Windows Forms RichTextBox 控制項可以寫入其以數種格式之一顯示的資訊:

  • 純文字

  • Unicode 純文字

  • RTF 格式 (RTF)

  • 使用空格取代 OLE 物件的 RTF

  • 使用 OLE 物件文字表示法的純文字

若要儲存檔案,請呼叫 SaveFile 方法。 您也可以使用 SaveFile 方法,將資料儲存至資料流。 如需詳細資訊,請參閱SaveFile(Stream, RichTextBoxStreamType)

將控制項的內容儲存至檔案

  1. 判斷要儲存的檔案路徑。

    若要在真實世界應用中執行此動作,您通常會使用 SaveFileDialog 元件。 如需概觀,請參閱 SaveFileDialog 元件概觀

  2. 呼叫 RichTextBox 控制項的 SaveFile 方法,指定要儲存的檔案,也可指定檔案類型。 如果呼叫的方法以檔案名稱為其唯一引數,則會以 RTF 的形式儲存檔案。 若要指定其他檔案類型,請呼叫以 RichTextBoxStreamType 列舉值為其第二個引數的方法。

    在下列範例中,針對 RTF 檔案位置設定的路徑是 [我的文件] 資料夾。 您可以假設大部分執行 Windows 作業系統的電腦都會包含這個資料夾,因此會使用這個位置。 選擇此位置也可讓具備最小系統存取層級的使用者安全地執行該應用程式。 下列範例會假設表單中已新增 RichTextBox 控制項。

    Public Sub SaveFile()
       ' You should replace the bold file name in the
       ' sample below with a file name of your own choosing.
       RichTextBox1.SaveFile(System.Environment.GetFolderPath _
       (System.Environment.SpecialFolder.Personal) _
       & "\Testdoc.rtf", _
          RichTextBoxStreamType.RichNoOleObjs)
    End Sub
    
    public void SaveFile()
    {
       // You should replace the bold file name in the
       // sample below with a file name of your own choosing.
       // Note the escape character used (@) when specifying the path.
       richTextBox1.SaveFile(System.Environment.GetFolderPath
       (System.Environment.SpecialFolder.Personal)
       + @"\Testdoc.rtf",
          RichTextBoxStreamType.RichNoOleObjs);
    }
    
    public:
       void SaveFile()
       {
          // You should replace the bold file name in the
          // sample below with a file name of your own choosing.
          richTextBox1->SaveFile(String::Concat
             (System::Environment::GetFolderPath
             (System::Environment::SpecialFolder::Personal),
             "\\Testdoc.rtf"), RichTextBoxStreamType::RichNoOleObjs);
       }
    

    重要

    如果檔案不存在,此範例就會建立新的檔案。 如果應用程式需要建立檔案,該應用程式就需要資料夾的建立權限。 您可以使用存取控制清單來設定權限。 如果檔案已經存在,則應用程式只需要寫入權限,這是較小的權限。 若有可能,更為安全的做法是在部署期間建立檔案,並且只授與單一檔案的讀取權限,而不授與資料夾的建立權限。 此外,將資料寫入使用者資料夾,而不是根資料夾或 Program Files 資料夾,也更加安全。

另請參閱