RichTextBox.LoadFile Méthode

Définition

Charge le contenu d'un fichier dans le contrôle RichTextBox.

Surcharges

LoadFile(String)

Charge un fichier RTF ou un fichier texte ASCII standard dans le contrôle RichTextBox.

LoadFile(Stream, RichTextBoxStreamType)

Charge le contenu d'un flux de données existant dans le contrôle RichTextBox.

LoadFile(String, RichTextBoxStreamType)

Charge un type de fichier spécifique dans le contrôle RichTextBox.

LoadFile(String)

Charge un fichier RTF ou un fichier texte ASCII standard dans le contrôle RichTextBox.

public void LoadFile (string path);

Paramètres

path
String

Nom et emplacement du fichier à charger dans le contrôle.

Exceptions

Une erreur s'est produite lors du chargement du fichier dans le contrôle.

Le fichier chargé n'est pas un document RTF.

Exemples

L’exemple de code suivant ouvre un fichier RTF dans le RichTextBox contrôle . L’exemple utilise la OpenFileDialog classe pour afficher une boîte de dialogue pour demander le fichier à l’utilisateur. Le code charge ensuite ce fichier en supposant qu’il s’agit d’un fichier de document RTF. Si le fichier n’est pas, l’exemple de code lève une exception. Cet exemple nécessite que le code soit placé dans une Form classe qui a un RichTextBox contrôle nommé richTextBox1.

public void LoadMyFile()
{
   // Create an OpenFileDialog to request a file to open.
   OpenFileDialog openFile1 = new OpenFileDialog();

   // Initialize the OpenFileDialog to look for RTF files.
   openFile1.DefaultExt = "*.rtf";
   openFile1.Filter = "RTF Files|*.rtf";

   // Determine whether the user selected a file from the OpenFileDialog.
   if(openFile1.ShowDialog() == System.Windows.Forms.DialogResult.OK &&
      openFile1.FileName.Length > 0) 
   {
      // Load the contents of the file into the RichTextBox.
      richTextBox1.LoadFile(openFile1.FileName);
   }
}

Remarques

Lors du chargement d’un fichier avec la LoadFile méthode , le contenu du fichier en cours de chargement remplace l’intégralité du contenu du RichTextBox contrôle. Cela entraîne la modification des valeurs des Text propriétés et Rtf . Vous pouvez utiliser cette méthode pour charger un texte ou un document RTF créé précédemment dans le contrôle à des fins de manipulation. Si vous souhaitez enregistrer le fichier, vous pouvez utiliser la SaveFile méthode .

Notes

Avec cette version de la LoadFile méthode, si le fichier en cours de chargement n’est pas un document RTF, une exception se produit. Pour charger un autre type de fichier, tel qu’un fichier texte ASCII, utilisez les autres versions de cette méthode qui acceptent une valeur de l’énumération RichTextBoxStreamType en tant que paramètre.

Notes

La LoadFile méthode n’ouvre pas de fichier tant qu’un handle n’est pas créé pour .RichTextBox Vérifiez que le handle du contrôle est créé avant d’appeler la LoadFile méthode .

Voir aussi

S’applique à

.NET Framework 4.8.1 et autres versions
Produit Versions
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

LoadFile(Stream, RichTextBoxStreamType)

Charge le contenu d'un flux de données existant dans le contrôle RichTextBox.

public void LoadFile (System.IO.Stream data, System.Windows.Forms.RichTextBoxStreamType fileType);

Paramètres

data
Stream

Flux de données à charger dans le contrôle RichTextBox.

fileType
RichTextBoxStreamType

Une des valeurs de l'objet RichTextBoxStreamType.

Exceptions

Une erreur s'est produite lors du chargement du fichier dans le contrôle.

.NET 5 et versions ultérieures : l’argument data est null.

Le fichier chargé n'est pas un document RTF.

Exemples

L’exemple de code suivant illustre l’utilisation des SaveFile méthodes et LoadFile avec des flux. Il illustre également l’utilisation des FileDialog.FileNamemembres , FileDialog.DefaultExt, SaveFileDialog.CreatePromptet SaveFileDialog.OverwritePrompt .

Il s’agit d’un exemple complet qui est prêt à être exécuté lorsque vous le copiez dans votre projet.

using System;
using System.Drawing;
using System.IO;
using System.Windows.Forms;

public partial class Form1: Form
{
    internal RichTextBox RichTextBox1;
    internal Button Button1;
    internal RichTextBox RichTextBox2;
    internal Button Button2;
    internal SaveFileDialog SaveFileDialog1;

    public Form1() : base()
    {   
        this.RichTextBox1 = new RichTextBox();
        this.Button1 = new Button();
        this.RichTextBox2 = new RichTextBox();
        this.Button2 = new Button();
        this.SaveFileDialog1 = new SaveFileDialog();
        this.SuspendLayout();
        this.RichTextBox1.Location = new Point(24, 64);
        this.RichTextBox1.Name = "RichTextBox1";
        this.RichTextBox1.TabIndex = 0;
        this.RichTextBox1.Text = "Type something here.";
        this.Button1.Location = new Point(96, 16);
        this.Button1.Name = "Button1";
        this.Button1.Size = new Size(96, 24);
        this.Button1.TabIndex = 1;
        this.Button1.Text = "Save To Stream";
        this.Button1.Click += new EventHandler(Button1_Click);
        this.RichTextBox2.Location = new Point(152, 64);
        this.RichTextBox2.Name = "RichTextBox2";
        this.RichTextBox2.TabIndex = 3;
        this.RichTextBox2.Text = 
            "It will be added to the stream and appear here.";
        this.Button2.Location = new Point(104, 200);
        this.Button2.Name = "Button2";
        this.Button2.Size = new Size(88, 32);
        this.Button2.TabIndex = 4;
        this.Button2.Text = "Save Stream To File";
        this.Button2.Click += new EventHandler(Button2_Click);
        this.ClientSize = new Size(292, 266);
        this.Controls.Add(this.Button2);
        this.Controls.Add(this.RichTextBox2);
        this.Controls.Add(this.Button1);
        this.Controls.Add(this.RichTextBox1);
        this.Name = "Form1";
        this.Text = "Form1";
        this.ResumeLayout(false);
    }

    public static void Main()
    {
        Application.Run(new Form1());
    }

    // Declare a new memory stream.
    MemoryStream userInput = new MemoryStream();

    // Save the content of RichTextBox1 to the memory stream, 
    // appending a LineFeed character.  
    private void Button1_Click(Object sender, EventArgs e)
    {
        RichTextBox1.SaveFile(userInput, RichTextBoxStreamType.PlainText);
        userInput.WriteByte(13);

        // Display the entire contents of the stream,
        // by setting its position to 0, to RichTextBox2.
        userInput.Position = 0;
        RichTextBox2.LoadFile(userInput, RichTextBoxStreamType.PlainText);
    }

    // Shows the use of a SaveFileDialog to save a MemoryStream to a file.
    private void Button2_Click(Object sender, EventArgs e)
    {
        // Set the properties on SaveFileDialog1 so the user is 
        // prompted to create the file if it doesn't exist 
        // or overwrite the file if it does exist.
        SaveFileDialog1.CreatePrompt = true;
        SaveFileDialog1.OverwritePrompt = true;

        // Set the file name to myText.txt, set the type filter
        // to text files, and set the initial directory to the 
        // MyDocuments folder.
        SaveFileDialog1.FileName = "myText";
        // DefaultExt is only used when "All files" is selected from 
        // the filter box and no extension is specified by the user.
        SaveFileDialog1.DefaultExt = "txt";
        SaveFileDialog1.Filter = 
            "Text files (*.txt)|*.txt|All files (*.*)|*.*";
        SaveFileDialog1.InitialDirectory = 
            Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);

        // Call ShowDialog and check for a return value of DialogResult.OK,
        // which indicates that the file was saved. 
        DialogResult result = SaveFileDialog1.ShowDialog();
        Stream fileStream;

        if (result == DialogResult.OK)
        {
            // Open the file, copy the contents of memoryStream to fileStream,
            // and close fileStream. Set the memoryStream.Position value to 0 
            // to copy the entire stream. 
            fileStream = SaveFileDialog1.OpenFile();
            userInput.Position = 0;
            userInput.WriteTo(fileStream);
            fileStream.Close();
        }
    }
}

Remarques

Vous pouvez utiliser cette version de la LoadFile méthode pour charger avec des RichTextBox données à partir d’un flux de données existant. Les données chargées dans le contrôle remplacent l’intégralité du contenu du RichTextBox contrôle. Cela entraîne la modification des valeurs des Text propriétés et Rtf . Vous pouvez utiliser cette méthode pour charger un fichier qui a été précédemment ouvert dans un flux de données dans le contrôle à des fins de manipulation. Si vous souhaitez enregistrer le contenu du contrôle dans le flux, vous pouvez utiliser la SaveFile méthode qui accepte un Stream objet en tant que paramètre.

Cette version de la LoadFile méthode vous permet également de spécifier le type de données en cours de chargement dans le contrôle. Cette fonctionnalité vous permet d’utiliser des flux de données qui contiennent des données autres que des documents RTF (Rich Text Format) dans le contrôle.

Notes

La LoadFile méthode n’ouvre pas de fichier tant qu’un handle n’est pas créé pour .RichTextBox Vérifiez que le handle du contrôle est créé avant d’appeler la LoadFile méthode .

Voir aussi

S’applique à

.NET Framework 4.8.1 et autres versions
Produit Versions
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

LoadFile(String, RichTextBoxStreamType)

Charge un type de fichier spécifique dans le contrôle RichTextBox.

public void LoadFile (string path, System.Windows.Forms.RichTextBoxStreamType fileType);

Paramètres

path
String

Nom et emplacement du fichier à charger dans le contrôle.

fileType
RichTextBoxStreamType

Une des valeurs de l'objet RichTextBoxStreamType.

Exceptions

Une erreur s'est produite lors du chargement du fichier dans le contrôle.

Le fichier chargé n'est pas un document RTF.

Exemples

L’exemple de code suivant ouvre un fichier texte dans le RichTextBox contrôle . L’exemple utilise la OpenFileDialog classe pour afficher une boîte de dialogue pour demander le fichier à l’utilisateur. Le code charge ensuite ce fichier dans le RichTextBox contrôle . L’exemple utilise cette version de la LoadFile méthode pour spécifier que le fichier doit être ouvert en tant que fichier texte ASCII au lieu du format texte enrichi standard. Cet exemple nécessite que le code soit placé dans une Form classe qui a un RichTextBox contrôle nommé richTextBox1.

public void LoadMyFile()
{
   // Create an OpenFileDialog to request a file to open.
   OpenFileDialog openFile1 = new OpenFileDialog();

   // Initialize the OpenFileDialog to look for RTF files.
   openFile1.DefaultExt = "*.rtf";
   openFile1.Filter = "RTF Files|*.rtf";

   // Determine whether the user selected a file from the OpenFileDialog.
   if(openFile1.ShowDialog() == System.Windows.Forms.DialogResult.OK &&
      openFile1.FileName.Length > 0) 
   {
      // Load the contents of the file into the RichTextBox.
      richTextBox1.LoadFile(openFile1.FileName, RichTextBoxStreamType.PlainText);
   }
}

Remarques

Lors du chargement d’un fichier avec la LoadFile méthode , le contenu du fichier en cours de chargement remplace l’intégralité du contenu du RichTextBox contrôle. Cela entraîne la modification des valeurs des Text propriétés et Rtf . Vous pouvez utiliser cette méthode pour charger un document texte ou RTF créé précédemment dans le contrôle à des fins de manipulation. Si vous souhaitez enregistrer le fichier, vous pouvez utiliser la SaveFile méthode .

Vous pouvez utiliser cette version de la LoadFile méthode pour spécifier le type de fichier du fichier en cours de chargement. Cette fonctionnalité vous permet de charger des fichiers autres que des documents RTF dans le contrôle.

Notes

La LoadFile méthode n’ouvre pas de fichier tant qu’un handle n’est pas créé pour .RichTextBox Vérifiez que le handle du contrôle est créé avant d’appeler la LoadFile méthode .

Voir aussi

S’applique à

.NET Framework 4.8.1 et autres versions
Produit Versions
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9