RichTextBox.LoadFile Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Laadt de inhoud van een bestand in het RichTextBox besturingselement.
Overloads
| Name | Description |
|---|---|
| LoadFile(String) |
Laadt een RTF-indeling (Rich Text Format) of standaard ASCII-tekstbestand in het RichTextBox besturingselement. |
| LoadFile(Stream, RichTextBoxStreamType) |
Laadt de inhoud van een bestaande gegevensstroom naar het RichTextBox besturingselement. |
| LoadFile(String, RichTextBoxStreamType) |
Laadt een specifiek type bestand in het RichTextBox besturingselement. |
LoadFile(String)
Laadt een RTF-indeling (Rich Text Format) of standaard ASCII-tekstbestand in het RichTextBox besturingselement.
public:
void LoadFile(System::String ^ path);
public void LoadFile(string path);
member this.LoadFile : string -> unit
Public Sub LoadFile (path As String)
Parameters
- path
- String
De naam en locatie van het bestand dat in het besturingselement moet worden geladen.
Uitzonderingen
Er is een fout opgetreden tijdens het laden van het bestand in het besturingselement.
Het bestand dat wordt geladen, is geen RTF-document.
Voorbeelden
In het volgende codevoorbeeld wordt een RTF-bestand in het RichTextBox besturingselement geopend. In het voorbeeld wordt de OpenFileDialog klasse gebruikt om een dialoogvenster weer te geven om het bestand van de gebruiker aan te vragen. Met de code wordt dat bestand geladen, ervan uitgaande dat het een RTF-documentbestand is. Als het bestand niet is, genereert de voorbeeldcode een uitzondering. In dit voorbeeld moet de code worden geplaatst in een Form klasse met een besturingselement met de RichTextBox naam richTextBox1.
public:
void LoadMyFile()
{
// Create an OpenFileDialog to request a file to open.
OpenFileDialog^ openFile1 = gcnew 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 );
}
}
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);
}
}
Public Sub LoadMyFile()
' Create an OpenFileDialog to request a file to open.
Dim openFile1 As 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) _
And (openFile1.FileName.Length > 0) Then
' Load the contents of the file into the RichTextBox.
richTextBox1.LoadFile(openFile1.FileName)
End If
End Sub
Opmerkingen
Bij het laden van een bestand met de LoadFile methode vervangt de inhoud van het bestand dat wordt geladen de volledige inhoud van het RichTextBox besturingselement. Hierdoor worden de waarden van de Text en Rtf eigenschappen gewijzigd. U kunt deze methode gebruiken om een eerder gemaakte tekst of RTF-document in het besturingselement te laden voor manipulatie. Als u het bestand wilt opslaan, kunt u de SaveFile methode gebruiken.
Note
Als het bestand dat wordt geladen geen RTF-document is, treedt er met deze versie van de LoadFile methode een uitzondering op. Als u een ander type bestand wilt laden, zoals een ASCII-tekstbestand, gebruikt u de andere versies van deze methode die een waarde uit de RichTextBoxStreamType opsomming als parameter accepteren.
Note
De LoadFile methode opent pas een bestand als er een ingang voor de RichTextBox. Zorg ervoor dat de ingang van het besturingselement is gemaakt voordat u de LoadFile methode aanroept.
Zie ook
Van toepassing op
LoadFile(Stream, RichTextBoxStreamType)
Laadt de inhoud van een bestaande gegevensstroom naar het RichTextBox besturingselement.
public:
void LoadFile(System::IO::Stream ^ data, System::Windows::Forms::RichTextBoxStreamType fileType);
public void LoadFile(System.IO.Stream data, System.Windows.Forms.RichTextBoxStreamType fileType);
member this.LoadFile : System.IO.Stream * System.Windows.Forms.RichTextBoxStreamType -> unit
Public Sub LoadFile (data As Stream, fileType As RichTextBoxStreamType)
Parameters
- data
- Stream
Een stroom met gegevens die in het RichTextBox besturingselement moeten worden geladen.
- fileType
- RichTextBoxStreamType
Een van de RichTextBoxStreamType waarden.
Uitzonderingen
Er is een fout opgetreden tijdens het laden van het bestand in het besturingselement.
.NET 5 en hoger: het argument data is null.
Het bestand dat wordt geladen, is geen RTF-document.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de SaveFile en LoadFile methoden met streams gebruikt. Het laat ook zien hoe de FileDialog.FileName, FileDialog.DefaultExten SaveFileDialog.CreatePromptSaveFileDialog.OverwritePrompt leden worden gebruikt.
Dit is een volledig voorbeeld dat klaar is om te worden uitgevoerd wanneer u het naar uw project kopieert.
using namespace System;
using namespace System::Drawing;
using namespace System::IO;
using namespace System::Windows::Forms;
public ref class Form1: public Form
{
public private:
RichTextBox^ RichTextBox1;
Button^ Button1;
RichTextBox^ RichTextBox2;
Button^ Button2;
SaveFileDialog^ SaveFileDialog1;
public:
Form1()
: Form()
{
userInput = gcnew MemoryStream;
this->RichTextBox1 = gcnew RichTextBox;
this->Button1 = gcnew Button;
this->RichTextBox2 = gcnew RichTextBox;
this->Button2 = gcnew Button;
this->SaveFileDialog1 = gcnew SaveFileDialog;
this->SuspendLayout();
this->RichTextBox1->Location = Point( 24, 64 );
this->RichTextBox1->Name = "RichTextBox1";
this->RichTextBox1->TabIndex = 0;
this->RichTextBox1->Text = "Type something here.";
this->Button1->Location = Point( 96, 16 );
this->Button1->Name = "Button1";
this->Button1->Size = Size( 96, 24 );
this->Button1->TabIndex = 1;
this->Button1->Text = "Save To Stream";
this->Button1->Click +=
gcnew EventHandler( this, &Form1::Button1_Click );
this->RichTextBox2->Location = 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 = Point( 104, 200 );
this->Button2->Name = "Button2";
this->Button2->Size = Size( 88, 32 );
this->Button2->TabIndex = 4;
this->Button2->Text = "Save Stream To File";
this->Button2->Click +=
gcnew EventHandler( this, &Form1::Button2_Click );
this->ClientSize = 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 );
}
// Declare a new memory stream.
MemoryStream^ userInput;
private:
// Save the content of RichTextBox1 to the memory stream,
// appending a LineFeed character.
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.
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 )
{
fileStream = SaveFileDialog1->OpenFile();
userInput->Position = 0;
userInput->WriteTo( fileStream );
fileStream->Close();
}
}
};
int main()
{
Application::Run( gcnew Form1 );
}
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();
}
}
}
Imports System.Drawing
Imports System.IO
Imports System.Windows.Forms
Partial Public Class Form1
Inherits Form
Friend WithEvents RichTextBox1 As RichTextBox
Friend WithEvents Button1 As Button
Friend WithEvents RichTextBox2 As RichTextBox
Friend WithEvents Button2 As Button
Friend WithEvents SaveFileDialog1 As SaveFileDialog
Public Sub New()
MyBase.New()
Me.RichTextBox1 = New RichTextBox
Me.Button1 = New Button
Me.RichTextBox2 = New RichTextBox
Me.Button2 = New Button
Me.SaveFileDialog1 = New SaveFileDialog
Me.SuspendLayout()
Me.RichTextBox1.Location = New Point(24, 64)
Me.RichTextBox1.Name = "RichTextBox1"
Me.RichTextBox1.TabIndex = 0
Me.RichTextBox1.Text = "Type something here."
Me.Button1.Location = New Point(96, 16)
Me.Button1.Name = "Button1"
Me.Button1.Size = New Size(96, 24)
Me.Button1.TabIndex = 1
Me.Button1.Text = "Save To Stream"
Me.RichTextBox2.Location = New Point(152, 64)
Me.RichTextBox2.Name = "RichTextBox2"
Me.RichTextBox2.TabIndex = 3
Me.RichTextBox2.Text = "It will be added to the stream and appear here."
Me.Button2.Location = New Point(104, 200)
Me.Button2.Name = "Button2"
Me.Button2.Size = New Size(88, 32)
Me.Button2.TabIndex = 4
Me.Button2.Text = "Save Stream To File"
Me.ClientSize = New Size(292, 266)
Me.Controls.Add(Me.Button2)
Me.Controls.Add(Me.RichTextBox2)
Me.Controls.Add(Me.Button1)
Me.Controls.Add(Me.RichTextBox1)
Me.Name = "Form1"
Me.Text = "Form1"
Me.ResumeLayout(False)
End Sub
Public Shared Sub Main()
Application.Run(New Form1)
End Sub
' Declare a new memory stream.
Dim userInput As New MemoryStream
' Save the content of RichTextBox1 to the memory stream, appending
'a LineFeed character.
Private Sub Button1_Click(ByVal sender As Object, _
ByVal e As EventArgs) Handles Button1.Click
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)
End Sub
' Shows the use of a SaveFileDialog to save a MemoryStream to a file.
Private Sub Button2_Click(ByVal sender As Object, _
ByVal e As EventArgs) Handles Button2.Click
' 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.
Dim result As DialogResult = SaveFileDialog1.ShowDialog()
Dim fileStream As Stream
If (result = DialogResult.OK) Then
' 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()
End If
End Sub
End Class
Opmerkingen
U kunt deze versie van de LoadFile methode gebruiken om de RichTextBox gegevens uit een bestaande gegevensstroom te laden. De gegevens die in het besturingselement worden geladen, vervangen de volledige inhoud van het RichTextBox besturingselement. Hierdoor worden de waarden van de Text en Rtf eigenschappen gewijzigd. U kunt deze methode gebruiken om een bestand te laden dat eerder is geopend in een gegevensstroom naar het besturingselement voor manipulatie. Als u de inhoud van het besturingselement weer in de stroom wilt opslaan, kunt u de SaveFile methode gebruiken waarmee een Stream object als parameter wordt geaccepteerd.
Met deze versie van de LoadFile methode kunt u ook het type gegevens opgeven dat in het besturingselement wordt geladen. Met deze functie kunt u gegevensstromen gebruiken die andere gegevens bevatten dan RTF-documenten (Rich Text Format) in het besturingselement.
Note
De LoadFile methode opent pas een bestand als er een ingang voor de RichTextBox. Zorg ervoor dat de ingang van het besturingselement is gemaakt voordat u de LoadFile methode aanroept.
Zie ook
Van toepassing op
LoadFile(String, RichTextBoxStreamType)
Laadt een specifiek type bestand in het RichTextBox besturingselement.
public:
void LoadFile(System::String ^ path, System::Windows::Forms::RichTextBoxStreamType fileType);
public void LoadFile(string path, System.Windows.Forms.RichTextBoxStreamType fileType);
member this.LoadFile : string * System.Windows.Forms.RichTextBoxStreamType -> unit
Public Sub LoadFile (path As String, fileType As RichTextBoxStreamType)
Parameters
- path
- String
De naam en locatie van het bestand dat in het besturingselement moet worden geladen.
- fileType
- RichTextBoxStreamType
Een van de RichTextBoxStreamType waarden.
Uitzonderingen
Er is een fout opgetreden tijdens het laden van het bestand in het besturingselement.
Het bestand dat wordt geladen, is geen RTF-document.
Voorbeelden
In het volgende codevoorbeeld wordt een tekstbestand geopend in het RichTextBox besturingselement. In het voorbeeld wordt de OpenFileDialog klasse gebruikt om een dialoogvenster weer te geven om het bestand van de gebruiker aan te vragen. De code laadt dat bestand vervolgens in het RichTextBox besturingselement. In het voorbeeld wordt deze versie van de LoadFile methode gebruikt om op te geven dat het bestand wordt geopend als een ASCII-tekstbestand in plaats van de standaard rtf-indeling. In dit voorbeeld moet de code worden geplaatst in een Form klasse met een besturingselement met de RichTextBox naam richTextBox1.
public:
void LoadMyFile()
{
// Create an OpenFileDialog to request a file to open.
OpenFileDialog^ openFile1 = gcnew 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 );
}
}
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);
}
}
Public Sub LoadMyFile()
' Create an OpenFileDialog to request a file to open.
Dim openFile1 As 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) _
And (openFile1.FileName.Length > 0) Then
' Load the contents of the file into the RichTextBox.
richTextBox1.LoadFile(openFile1.FileName, _
RichTextBoxStreamType.PlainText)
End If
End Sub
Opmerkingen
Bij het laden van een bestand met de LoadFile methode vervangt de inhoud van het bestand dat wordt geladen de volledige inhoud van het RichTextBox besturingselement. Hierdoor worden de waarden van de Text en Rtf eigenschappen gewijzigd. U kunt deze methode gebruiken om een eerder gemaakt tekst- of RTF-document (RTF) te laden in het besturingselement voor manipulatie. Als u het bestand wilt opslaan, kunt u de SaveFile methode gebruiken.
U kunt deze versie van de LoadFile methode gebruiken om het bestandstype op te geven van het bestand dat wordt geladen. Met deze functie kunt u andere bestanden dan RTF-documenten in het besturingselement laden.
Note
De LoadFile methode opent pas een bestand als er een ingang voor de RichTextBox. Zorg ervoor dat de ingang van het besturingselement is gemaakt voordat u de LoadFile methode aanroept.