Compartilhar via


Como: Salvar arquivos com o controle RichTextBox do Windows Forms

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

  • Texto sem formatação

  • Texto sem formatação de Unicode

  • Formato Rich Text (RTF)

  • RTF com espaços no lugar dos 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 SaveFile método 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 seja salvo.

    Para fazer isso em um aplicativo do mundo real, você normalmente usaria o SaveFileDialog componente. Para obter uma visão geral, consulte Visão geral do SaveFileDialog Component (Windows Forms).

  2. Chamar o SaveFile método de RichTextBox controle, especificando o arquivo para salvar e, opcionalmente, um arquivo de tipo. 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 igual a RichTextBoxStreamType enumeração como seu segundo argumento.

    No exemplo abaixo, o caminho definido para o local do arquivo rich text é o Meus documentos pasta. Este local é usado porque você pode assumir que a maioria dos computadores que executam o sistema operacional Windows inclua essa pasta. Escolha este local também permite que os usuários com níveis de acesso do sistema mínimo com segurança, execute o aplicativo. O exemplo a seguir supõe um formulário com um RichTextBox controle 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(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);
       }
    
    Observação de segurançaObservação sobre segurança

    Este exemplo cria um novo arquivo, se o arquivo ainda não existir. Se um aplicativo precisa criar um arquivo, esse aplicativo precisa criar acesso para a pasta. Permissões são feitas com listas de controle de acesso. Se o arquivo já existir, o aplicativo precisa somente acesso de gravação, um privilégio menor. Sempre que possível, é mais seguro criar o arquivo durante a implantação e apenas conceder acesso de leitura para um único arquivo, em vez de criar uma pasta de acesso. Além disso, é mais seguro gravar dados em pastas de usuário que em pasta raiz ou em pasta Program Files.

Consulte também

Referência

RichTextBox.SaveFile

RichTextBox

Outros recursos

Controle RichTextBox (Windows Forms)

Controles para uso no Windows Forms