Compartilhar via

Como salvar arquivos com o controle RichTextBox dos Windows Forms

O controle do Windows Forms RichTextBox pode gravar as informações exibidas em um dos vários formatos:

  • Texto sem formatação

  • Texto sem formatação Unicode

  • RTF (formato Rich-Text)

  • RTF com espaços no lugar de objetos OLE

  • Texto sem formatação com uma representação textual de objetos OLE

Para salvar um arquivo, chame o SaveFile método. Você também pode usar o método SaveFile para salvar dados em um fluxo. Para obter mais informações, consulte SaveFile(Stream, RichTextBoxStreamType).

Para salvar o conteúdo do controle em um arquivo

  1. Determine o caminho do arquivo a ser salvo.

    Para fazer isso em um aplicativo do mundo real, você normalmente usaria o SaveFileDialog componente. Para obter uma visão geral, consulte a visão geral do componente SaveFileDialog.

  2. Chame o SaveFile método do RichTextBox controle, especificando o arquivo para salvar e, opcionalmente, um tipo de arquivo. Se você chamar o método com um nome de arquivo como seu único argumento, o arquivo será salvo como RTF. Para especificar outro tipo de arquivo, chame o método com um valor da RichTextBoxStreamType enumeração como seu segundo argumento.

    No exemplo abaixo, o caminho definido para o local do arquivo rich-text é a pasta Meus Documentos . Esse local é usado porque você pode assumir que a maioria dos computadores que executam o sistema operacional Windows incluirá essa pasta. Escolher esse local também permite que usuários com níveis mínimos de acesso do sistema executem o aplicativo com segurança. O exemplo a seguir pressupõe um formulário com um controle de RichTextBox já adicionado.

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

    Importante

    Este exemplo criará um novo arquivo, se o arquivo ainda não existir. Se um aplicativo precisar criar um arquivo, esse aplicativo precisará criar acesso para a pasta. As permissões são definidas usando listas de controle de acesso. Se o arquivo já existir, o aplicativo precisará apenas de acesso de gravação, um privilégio menor. Sempre que possível, é mais seguro criar o arquivo durante a implantação e conceder apenas acesso de leitura a um único arquivo, em vez de criar acesso para uma pasta. Além disso, é mais seguro gravar dados em pastas de usuário do que na pasta raiz ou na pasta Arquivos de Programas.

Consulte também

  • Last updated on