StreamWriter Constructors
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.
Initialiseert een nieuw exemplaar van de StreamWriter klasse.
Overloads
| Name | Description |
|---|---|
| StreamWriter(Stream) |
Initialiseert een nieuw exemplaar van de StreamWriter klasse voor de opgegeven stroom met behulp van UTF-8-codering en de standaardbuffergrootte. |
| StreamWriter(String) |
Initialiseert een nieuw exemplaar van de StreamWriter klasse voor het opgegeven bestand met behulp van de standaardcodering en buffergrootte. |
| StreamWriter(Stream, Encoding) |
Initialiseert een nieuw exemplaar van de klasse voor de StreamWriter opgegeven stream met behulp van de opgegeven codering en de standaardbuffergrootte. |
| StreamWriter(String, Boolean) |
Initialiseert een nieuw exemplaar van de StreamWriter klasse voor het opgegeven bestand met behulp van de standaardcodering en buffergrootte. Als het bestand bestaat, kan het worden overschreven of toegevoegd aan. Als het bestand niet bestaat, maakt deze constructor een nieuw bestand. |
| StreamWriter(Stream, Encoding, Int32) |
Initialiseert een nieuw exemplaar van de StreamWriter klasse voor de opgegeven stream met behulp van de opgegeven coderings- en buffergrootte. |
| StreamWriter(String, Boolean, Encoding) |
Initialiseert een nieuw exemplaar van de StreamWriter klasse voor het opgegeven bestand met behulp van de opgegeven codering en de standaardbuffergrootte. Als het bestand bestaat, kan het worden overschreven of toegevoegd aan. Als het bestand niet bestaat, maakt deze constructor een nieuw bestand. |
| StreamWriter(Stream, Encoding, Int32, Boolean) |
Initialiseert een nieuw exemplaar van de klasse voor de StreamWriter opgegeven stream met behulp van de opgegeven coderings- en buffergrootte, en laat de stream eventueel open. |
| StreamWriter(String, Boolean, Encoding, Int32) |
Initialiseert een nieuw exemplaar van de StreamWriter klasse voor het opgegeven bestand op het opgegeven pad, met behulp van de opgegeven coderings- en buffergrootte. Als het bestand bestaat, kan het worden overschreven of toegevoegd aan. Als het bestand niet bestaat, maakt deze constructor een nieuw bestand. |
StreamWriter(Stream)
Initialiseert een nieuw exemplaar van de StreamWriter klasse voor de opgegeven stroom met behulp van UTF-8-codering en de standaardbuffergrootte.
public:
StreamWriter(System::IO::Stream ^ stream);
public StreamWriter(System.IO.Stream stream);
new System.IO.StreamWriter : System.IO.Stream -> System.IO.StreamWriter
Public Sub New (stream As Stream)
Parameters
- stream
- Stream
De stroom waar naar moet worden geschreven.
Uitzonderingen
stream is niet beschrijfbaar.
stream is null.
Voorbeelden
In het volgende codevoorbeeld ziet u deze constructor.
using System;
using System.IO;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
FileStream fs = null;
try
{
fs = new FileStream(fileName, FileMode.CreateNew);
using (StreamWriter writer = new StreamWriter(fs))
{
writer.Write(textToAdd);
}
}
finally
{
if (fs != null)
fs.Dispose();
}
}
}
}
Imports System.IO
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Dim fs As FileStream = Nothing
Try
fs = New FileStream(fileName, FileMode.CreateNew)
Using writer As StreamWriter = New StreamWriter(fs)
writer.Write(textToAdd)
End Using
Finally
If Not fs Is Nothing Then
fs.Dispose()
End If
End Try
End Sub
End Module
Opmerkingen
Deze constructor maakt een StreamWriter met UTF-8-codering zonder een Byte-Order Mark (BOM), zodat de GetPreamble methode een lege bytematrix retourneert. De standaard-UTF-8-codering voor deze constructor genereert een uitzondering op ongeldige bytes. Dit gedrag verschilt van het gedrag dat wordt geleverd door het coderingsobject in de Encoding.UTF8 eigenschap. Als u wilt opgeven of een uitzondering wordt gegenereerd op ongeldige bytes, gebruikt u een constructor die een coderingsobject accepteert als een parameter, zoals StreamWriter. De BaseStream eigenschap wordt geïnitialiseerd met behulp van de stream parameter. De positie van de stream wordt niet opnieuw ingesteld.
Het StreamWriter object roept Dispose() het opgegeven Stream object aan wanneer StreamWriter.Dispose het wordt aangeroepen.
Caution
Wanneer u een set tekens compileert met een bepaalde culturele instelling en dezelfde tekens met een andere culturele instelling ophaalt, kunnen de tekens mogelijk niet worden geïnterpreteerd en kan er een uitzondering optreden.
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.
Zie ook
- Bestands- en Stream-I/O
- Procedure: Tekst uit een bestand lezen
- Procedure: Tekst naar een bestand schrijven
Van toepassing op
StreamWriter(String)
Initialiseert een nieuw exemplaar van de StreamWriter klasse voor het opgegeven bestand met behulp van de standaardcodering en buffergrootte.
public:
StreamWriter(System::String ^ path);
public StreamWriter(string path);
new System.IO.StreamWriter : string -> System.IO.StreamWriter
Public Sub New (path As String)
Parameters
- path
- String
Het volledige bestandspad naar schrijven.
path kan een bestandsnaam zijn.
Uitzonderingen
Toegang wordt geweigerd.
path is een lege tekenreeks ("").
– of –
path bevat de naam van een systeemapparaat (com1, com2, enzovoort).
path is null.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.
path bevat een onjuiste of ongeldige syntaxis voor bestandsnaam, mapnaam of volumelabelsyntaxis.
De beller heeft niet de vereiste machtiging.
Voorbeelden
In het volgende codevoorbeeld ziet u deze constructor.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
using (StreamWriter writer = new StreamWriter(fileName))
{
writer.Write(textToAdd);
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Using writer As StreamWriter = New StreamWriter(fileName)
writer.Write(textToAdd)
End Using
End Sub
End Module
Opmerkingen
Deze constructor maakt een StreamWriter met UTF-8-codering zonder een Byte-Order Mark (BOM), zodat de GetPreamble methode een lege bytematrix retourneert. De standaard-UTF-8-codering voor deze constructor genereert een uitzondering op ongeldige bytes. Dit gedrag verschilt van het gedrag dat wordt geleverd door het coderingsobject in de Encoding.UTF8 eigenschap. Als u een stuklijst wilt opgeven en wilt bepalen of er een uitzondering wordt gegenereerd op ongeldige bytes, gebruikt u een constructor die een coderingsobject accepteert als een parameter, zoals StreamWriter(String, Boolean, Encoding).
De path parameter kan een bestandsnaam zijn, inclusief een bestand op een UNC-share (Universal Naming Convention). Als het bestand bestaat, wordt het overschreven; anders wordt er een nieuw bestand gemaakt.
De parameter hoeft geen bestand te zijn dat is opgeslagen op schijf. Het path kan deel uitmaken van een systeem dat toegang via streams ondersteunt.
Caution
Wanneer u een set tekens compileert met een bepaalde culturele instelling en dezelfde tekens met een andere culturele instelling ophaalt, kunnen de tekens mogelijk niet worden geïnterpreteerd en kan er een uitzondering optreden.
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.
Zie ook
- Bestands- en Stream-I/O
- Procedure: Tekst uit een bestand lezen
- Procedure: Tekst naar een bestand schrijven
Van toepassing op
StreamWriter(Stream, Encoding)
Initialiseert een nieuw exemplaar van de klasse voor de StreamWriter opgegeven stream met behulp van de opgegeven codering en de standaardbuffergrootte.
public:
StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding);
public StreamWriter(System.IO.Stream stream, System.Text.Encoding encoding);
new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding -> System.IO.StreamWriter
Public Sub New (stream As Stream, encoding As Encoding)
Parameters
- stream
- Stream
De stroom waar naar moet worden geschreven.
- encoding
- Encoding
De tekencodering die moet worden gebruikt.
Uitzonderingen
stream of encoding is null.
stream is niet beschrijfbaar.
Voorbeelden
In het volgende voorbeeld ziet u deze constructor.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
FileStream fs = null;
try
{
fs = new FileStream(fileName, FileMode.CreateNew);
using (StreamWriter writer = new StreamWriter(fs, Encoding.Default))
{
writer.Write(textToAdd);
}
}
finally
{
if (fs != null)
fs.Dispose();
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Dim fs As FileStream = Nothing
Try
fs = New FileStream(fileName, FileMode.CreateNew)
Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default)
writer.Write(textToAdd)
End Using
Finally
If Not fs Is Nothing Then
fs.Dispose()
End If
End Try
End Sub
End Module
Opmerkingen
Met deze constructor wordt de Encoding eigenschap geïnitialiseerd met behulp van de coderingsparameter en de BaseStream eigenschap met behulp van de streamparameter. De positie van de stream wordt niet opnieuw ingesteld. Zie Encodingvoor meer informatie.
Het StreamWriter object roept Dispose() het opgegeven Stream object aan wanneer StreamWriter.Dispose het wordt aangeroepen.
Caution
Wanneer u een set tekens compileert met een bepaalde culturele instelling en dezelfde tekens met een andere culturele instelling ophaalt, kunnen de tekens mogelijk niet worden geïnterpreteerd en kan er een uitzondering optreden.
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.
Zie ook
- Encoding
- Bestands- en Stream-I/O
- Procedure: Tekst uit een bestand lezen
- Procedure: Tekst naar een bestand schrijven
Van toepassing op
StreamWriter(String, Boolean)
Initialiseert een nieuw exemplaar van de StreamWriter klasse voor het opgegeven bestand met behulp van de standaardcodering en buffergrootte. Als het bestand bestaat, kan het worden overschreven of toegevoegd aan. Als het bestand niet bestaat, maakt deze constructor een nieuw bestand.
public:
StreamWriter(System::String ^ path, bool append);
public StreamWriter(string path, bool append);
new System.IO.StreamWriter : string * bool -> System.IO.StreamWriter
Public Sub New (path As String, append As Boolean)
Parameters
- path
- String
Het volledige bestandspad naar schrijven.
- append
- Boolean
true om gegevens toe te voegen aan het bestand; false om het bestand te overschrijven. Als het opgegeven bestand niet bestaat, heeft deze parameter geen effect en maakt de constructor een nieuw bestand.
Uitzonderingen
Toegang wordt geweigerd.
path is leeg.
– of –
path bevat de naam van een systeemapparaat (com1, com2, enzovoort).
path is null.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
path bevat een onjuiste of ongeldige syntaxis voor bestandsnaam, mapnaam of volumelabelsyntaxis.
Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.
De beller heeft niet de vereiste machtiging.
Voorbeelden
In het volgende codevoorbeeld ziet u deze constructor.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
using (StreamWriter writer = new StreamWriter(fileName, true))
{
writer.Write(textToAdd);
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Using writer As StreamWriter = New StreamWriter(fileName, True)
writer.Write(textToAdd)
End Using
End Sub
End Module
Opmerkingen
Deze constructor maakt een StreamWriter met UTF-8-codering zonder een Byte-Order Mark (BOM), zodat de GetPreamble methode een lege bytematrix retourneert. De standaard-UTF-8-codering voor deze constructor genereert een uitzondering op ongeldige bytes. Dit gedrag verschilt van het gedrag dat wordt geleverd door het coderingsobject in de Encoding.UTF8 eigenschap. Als u een stuklijst wilt opgeven en wilt bepalen of er een uitzondering wordt gegenereerd op ongeldige bytes, gebruikt u een constructor die een coderingsobject accepteert als een parameter, zoals StreamWriter(String, Boolean, Encoding).
De path parameter kan een bestandsnaam zijn, inclusief een bestand op een UNC-share (Universal Naming Convention).
De parameter hoeft geen bestand te zijn dat is opgeslagen op schijf. Het path kan deel uitmaken van een systeem dat toegang via streams ondersteunt.
Caution
Wanneer u een set tekens compileert met een bepaalde culturele instelling en dezelfde tekens met een andere culturele instelling ophaalt, kunnen de tekens mogelijk niet worden geïnterpreteerd en kan er een uitzondering optreden.
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.
Zie ook
- Bestands- en Stream-I/O
- Procedure: Tekst uit een bestand lezen
- Procedure: Tekst naar een bestand schrijven
Van toepassing op
StreamWriter(Stream, Encoding, Int32)
Initialiseert een nieuw exemplaar van de StreamWriter klasse voor de opgegeven stream met behulp van de opgegeven coderings- en buffergrootte.
public:
StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, int bufferSize);
public StreamWriter(System.IO.Stream stream, System.Text.Encoding encoding, int bufferSize);
new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int -> System.IO.StreamWriter
Public Sub New (stream As Stream, encoding As Encoding, bufferSize As Integer)
Parameters
- stream
- Stream
De stroom waar naar moet worden geschreven.
- encoding
- Encoding
De tekencodering die moet worden gebruikt.
- bufferSize
- Int32
De buffergrootte, in tekens.
Uitzonderingen
stream of encoding is null.
bufferSize is kleiner dan of gelijk aan nul, met uitzondering van -1, die de standaardbuffergrootte mag aangeven.
stream is niet beschrijfbaar.
Voorbeelden
In het volgende voorbeeld ziet u deze constructor.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
FileStream fs = null;
try
{
fs = new FileStream(fileName, FileMode.CreateNew);
using (StreamWriter writer = new StreamWriter(fs, Encoding.UTF8, 512))
{
writer.Write(textToAdd);
}
}
finally
{
if (fs != null)
fs.Dispose();
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Dim fs As FileStream = Nothing
Try
fs = New FileStream(fileName, FileMode.CreateNew)
Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default, 512)
writer.Write(textToAdd)
End Using
Finally
If Not fs Is Nothing Then
fs.Dispose()
End If
End Try
End Sub
End Module
Opmerkingen
Met deze constructor wordt de Encoding eigenschap geïnitialiseerd met behulp van de encoding parameter en de BaseStream eigenschap met behulp van de stream parameter. De positie van de stream wordt niet opnieuw ingesteld. Zie Encodingvoor meer informatie.
Het StreamWriter object roept Dispose() het opgegeven Stream object aan wanneer StreamWriter.Dispose het wordt aangeroepen.
Caution
Wanneer u een set tekens compileert met een bepaalde culturele instelling en dezelfde tekens met een andere culturele instelling ophaalt, kunnen de tekens mogelijk niet worden geïnterpreteerd en kan er een uitzondering optreden.
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.
Zie ook
- Encoding
- Bestands- en Stream-I/O
- Procedure: Tekst uit een bestand lezen
- Procedure: Tekst naar een bestand schrijven
Van toepassing op
StreamWriter(String, Boolean, Encoding)
Initialiseert een nieuw exemplaar van de StreamWriter klasse voor het opgegeven bestand met behulp van de opgegeven codering en de standaardbuffergrootte. Als het bestand bestaat, kan het worden overschreven of toegevoegd aan. Als het bestand niet bestaat, maakt deze constructor een nieuw bestand.
public:
StreamWriter(System::String ^ path, bool append, System::Text::Encoding ^ encoding);
public StreamWriter(string path, bool append, System.Text.Encoding encoding);
new System.IO.StreamWriter : string * bool * System.Text.Encoding -> System.IO.StreamWriter
Public Sub New (path As String, append As Boolean, encoding As Encoding)
Parameters
- path
- String
Het volledige bestandspad naar schrijven.
- append
- Boolean
true om gegevens toe te voegen aan het bestand; false om het bestand te overschrijven. Als het opgegeven bestand niet bestaat, heeft deze parameter geen effect en maakt de constructor een nieuw bestand.
- encoding
- Encoding
De tekencodering die moet worden gebruikt.
Uitzonderingen
Toegang wordt geweigerd.
path is leeg.
– of –
path bevat de naam van een systeemapparaat (com1, com2, enzovoort).
path is null.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
path bevat een onjuiste of ongeldige syntaxis voor bestandsnaam, mapnaam of volumelabelsyntaxis.
Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.
De beller heeft niet de vereiste machtiging.
Voorbeelden
In het volgende voorbeeld ziet u deze constructor.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
using (StreamWriter writer = new StreamWriter(fileName, true, Encoding.UTF8))
{
writer.Write(textToAdd);
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Using writer As StreamWriter = New StreamWriter(fileName, True, Encoding.UTF8)
writer.Write(textToAdd)
End Using
End Sub
End Module
Opmerkingen
Met deze constructor wordt de Encoding eigenschap geïnitialiseerd met behulp van de coderingsparameter. Zie Encodingvoor meer informatie.
path kan een bestandsnaam zijn, inclusief een bestand op een UNC-share (Universal Naming Convention).
path is niet vereist om een bestand te zijn opgeslagen op schijf; het kan deel uitmaken van een systeem dat toegang via streams ondersteunt.
Caution
Wanneer u een set tekens compileert met een bepaalde culturele instelling en dezelfde tekens met een andere culturele instelling ophaalt, kunnen de tekens mogelijk niet worden geïnterpreteerd en kan er een uitzondering optreden.
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.
Zie ook
- Encoding
- Bestands- en Stream-I/O
- Procedure: Tekst uit een bestand lezen
- Procedure: Tekst naar een bestand schrijven
Van toepassing op
StreamWriter(Stream, Encoding, Int32, Boolean)
Initialiseert een nieuw exemplaar van de klasse voor de StreamWriter opgegeven stream met behulp van de opgegeven coderings- en buffergrootte, en laat de stream eventueel open.
public:
StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, int bufferSize, bool leaveOpen);
public StreamWriter(System.IO.Stream stream, System.Text.Encoding encoding, int bufferSize, bool leaveOpen);
new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int * bool -> System.IO.StreamWriter
Public Sub New (stream As Stream, encoding As Encoding, bufferSize As Integer, leaveOpen As Boolean)
Parameters
- stream
- Stream
De stroom waar naar moet worden geschreven.
- encoding
- Encoding
De tekencodering die moet worden gebruikt.
- bufferSize
- Int32
De buffergrootte, in tekens.
- leaveOpen
- Boolean
true om de stroom open te laten nadat het StreamWriter object is verwijderd; falseanders.
Uitzonderingen
stream of encoding is null.
bufferSize is kleiner dan of gelijk aan nul, met uitzondering van -1, die de standaardbuffergrootte mag aangeven.
stream is niet beschrijfbaar.
Voorbeelden
In het volgende voorbeeld ziet u deze constructor.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
FileStream fs = null;
try
{
fs = new FileStream(fileName, FileMode.CreateNew);
using (StreamWriter writer = new StreamWriter(fs, Encoding.UTF8, 512, false))
{
writer.Write(textToAdd);
}
}
finally
{
if (fs != null)
fs.Dispose();
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Dim fs As FileStream = Nothing
Try
fs = New FileStream(fileName, FileMode.CreateNew)
Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default, 512, False)
writer.Write(textToAdd)
End Using
Finally
If Not fs Is Nothing Then
fs.Dispose()
End If
End Try
End Sub
End Module
Opmerkingen
Tenzij u de leaveOpen parameter trueinstelt op, roept Dispose() het object het StreamWriter opgegeven Stream object aan wanneer StreamWriter.Dispose het wordt aangeroepen.
Met deze constructor wordt de Encoding eigenschap geïnitialiseerd met behulp van de encoding parameter en wordt de BaseStream eigenschap geïnitialiseerd met behulp van de stream parameter. De positie van de stream wordt niet opnieuw ingesteld. Zie de Encoding eigenschap voor meer informatie.
Caution
Wanneer u een set tekens compileert met een bepaalde culturele instelling en dezelfde tekens met een andere culturele instelling ophaalt, kunnen de tekens mogelijk niet worden geïnterpreteerd en kan er een uitzondering optreden.
Van toepassing op
StreamWriter(String, Boolean, Encoding, Int32)
Initialiseert een nieuw exemplaar van de StreamWriter klasse voor het opgegeven bestand op het opgegeven pad, met behulp van de opgegeven coderings- en buffergrootte. Als het bestand bestaat, kan het worden overschreven of toegevoegd aan. Als het bestand niet bestaat, maakt deze constructor een nieuw bestand.
public:
StreamWriter(System::String ^ path, bool append, System::Text::Encoding ^ encoding, int bufferSize);
public StreamWriter(string path, bool append, System.Text.Encoding encoding, int bufferSize);
new System.IO.StreamWriter : string * bool * System.Text.Encoding * int -> System.IO.StreamWriter
Public Sub New (path As String, append As Boolean, encoding As Encoding, bufferSize As Integer)
Parameters
- path
- String
Het volledige bestandspad naar schrijven.
- append
- Boolean
true om gegevens toe te voegen aan het bestand; false om het bestand te overschrijven. Als het opgegeven bestand niet bestaat, heeft deze parameter geen effect en maakt de constructor een nieuw bestand.
- encoding
- Encoding
De tekencodering die moet worden gebruikt.
- bufferSize
- Int32
De buffergrootte, in tekens.
Uitzonderingen
path is een lege tekenreeks ("").
– of –
path bevat de naam van een systeemapparaat (com1, com2, enzovoort).
path of encoding is null.
bufferSize is kleiner dan of gelijk aan nul, met uitzondering van -1, die de standaardbuffergrootte mag aangeven.
path bevat een onjuiste of ongeldige syntaxis voor bestandsnaam, mapnaam of volumelabelsyntaxis.
De beller heeft niet de vereiste machtiging.
Toegang wordt geweigerd.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.
Voorbeelden
In het volgende voorbeeld ziet u deze constructor.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
using (StreamWriter writer = new StreamWriter(fileName, true, Encoding.UTF8, 512))
{
writer.Write(textToAdd);
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Using writer As StreamWriter = New StreamWriter(fileName, True, Encoding.UTF8, 512)
writer.Write(textToAdd)
End Using
End Sub
End Module
Opmerkingen
Met deze constructor wordt de Encoding eigenschap geïnitialiseerd met behulp van de coderingsparameter. Zie Encodingvoor meer informatie.
path kan een bestandsnaam zijn, inclusief een bestand op een UNC-share (Universal Naming Convention).
path is niet vereist om een bestand te zijn opgeslagen op schijf; het kan deel uitmaken van een systeem dat toegang via streams ondersteunt.
Caution
Wanneer u een set tekens compileert met een bepaalde culturele instelling en dezelfde tekens met een andere culturele instelling ophaalt, kunnen de tekens mogelijk niet worden geïnterpreteerd en kan er een uitzondering optreden.
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.
Zie ook
- Encoding
- Bestands- en Stream-I/O
- Procedure: Tekst uit een bestand lezen
- Procedure: Tekst naar een bestand schrijven