StreamWriter Konstruktorer
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Initierar en ny instans av StreamWriter klassen.
Överlagringar
| Name | Description |
|---|---|
| StreamWriter(Stream) |
Initierar en ny instans av StreamWriter klassen för den angivna strömmen med hjälp av UTF-8-kodning och standardbuffertstorleken. |
| StreamWriter(String) |
Initierar en ny instans av StreamWriter klassen för den angivna filen med hjälp av standardkodning och buffertstorlek. |
| StreamWriter(Stream, Encoding) |
Initierar en ny instans av StreamWriter klassen för den angivna strömmen med hjälp av den angivna kodningen och standardbuffertstorleken. |
| StreamWriter(String, Boolean) |
Initierar en ny instans av StreamWriter klassen för den angivna filen med hjälp av standardkodning och buffertstorlek. Om filen finns kan den antingen skrivas över eller läggas till. Om filen inte finns skapar konstruktorn en ny fil. |
| StreamWriter(Stream, Encoding, Int32) |
Initierar en ny instans av StreamWriter klassen för den angivna dataströmmen med den angivna kodnings- och buffertstorleken. |
| StreamWriter(String, Boolean, Encoding) |
Initierar en ny instans av StreamWriter klassen för den angivna filen med hjälp av den angivna kodningen och standardbuffertstorleken. Om filen finns kan den antingen skrivas över eller läggas till. Om filen inte finns skapar konstruktorn en ny fil. |
| StreamWriter(Stream, Encoding, Int32, Boolean) |
Initierar en ny instans av StreamWriter klassen för den angivna dataströmmen med den angivna kodnings- och buffertstorleken, och om du vill kan du lämna strömmen öppen. |
| StreamWriter(String, Boolean, Encoding, Int32) |
Initierar en ny instans av StreamWriter klassen för den angivna filen på den angivna sökvägen med den angivna kodnings- och buffertstorleken. Om filen finns kan den antingen skrivas över eller läggas till. Om filen inte finns skapar konstruktorn en ny fil. |
StreamWriter(Stream)
Initierar en ny instans av StreamWriter klassen för den angivna strömmen med hjälp av UTF-8-kodning och standardbuffertstorleken.
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)
Parametrar
- stream
- Stream
Dataströmmen att skriva till.
Undantag
stream är inte skrivbar.
stream är null.
Exempel
Följande kodexempel visar den här konstruktorn.
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
Kommentarer
Den här konstruktorn skapar en StreamWriter med UTF-8-kodning utan en Byte-Order Mark (BOM), så dess GetPreamble metod returnerar en tom bytematris. Utf-8-standardkodningen för den här konstruktorn genererar ett undantag på ogiltiga byte. Det här beteendet skiljer sig från det beteende som tillhandahålls av kodningsobjektet Encoding.UTF8 i egenskapen. Om du vill ange om ett undantag genereras på ogiltiga byte använder du en konstruktor som accepterar ett kodningsobjekt som en parameter, till exempel StreamWriter. Egenskapen BaseStream initieras med hjälp av parametern stream . Strömmens position återställs inte.
Objektet StreamWriter anropar Dispose() det angivna Stream objektet när StreamWriter.Dispose det anropas.
Caution
När du kompilerar en uppsättning tecken med en viss kulturell inställning och hämtar samma tecken med en annan kulturell inställning kanske tecknen inte kan tolkas och kan orsaka ett undantag.
En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.
Se även
Gäller för
StreamWriter(String)
Initierar en ny instans av StreamWriter klassen för den angivna filen med hjälp av standardkodning och buffertstorlek.
public:
StreamWriter(System::String ^ path);
public StreamWriter(string path);
new System.IO.StreamWriter : string -> System.IO.StreamWriter
Public Sub New (path As String)
Parametrar
- path
- String
Den fullständiga filsökvägen att skriva till.
path kan vara ett filnamn.
Undantag
Åtkomst avslås.
path är en tom sträng ("").
-eller-
path innehåller namnet på en systemenhet (com1, com2 och så vidare).
path är null.
Den angivna sökvägen är ogiltig (den finns till exempel på en ommappad enhet).
Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.
path innehåller en felaktig eller ogiltig syntax för filnamn, katalognamn eller volymetikettsyntax.
Anroparen har inte den behörighet som krävs.
Exempel
Följande kodexempel visar den här konstruktorn.
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
Kommentarer
Den här konstruktorn skapar en StreamWriter med UTF-8-kodning utan en Byte-Order Mark (BOM), så dess GetPreamble metod returnerar en tom bytematris. Utf-8-standardkodningen för den här konstruktorn genererar ett undantag på ogiltiga byte. Det här beteendet skiljer sig från det beteende som tillhandahålls av kodningsobjektet Encoding.UTF8 i egenskapen. Om du vill ange en strukturlista och avgöra om ett undantag genereras på ogiltiga byte använder du en konstruktor som accepterar ett kodningsobjekt som en parameter, till exempel StreamWriter(String, Boolean, Encoding).
Parametern path kan vara ett filnamn, inklusive en fil på en UNC-resurs (Universal Naming Convention). Om filen finns skrivs den över. annars skapas en ny fil.
Parametern måste inte vara en fil som lagras på disken. Den path kan vara en del av ett system som stöder åtkomst med hjälp av strömmar.
Caution
När du kompilerar en uppsättning tecken med en viss kulturell inställning och hämtar samma tecken med en annan kulturell inställning kanske tecknen inte kan tolkas och kan orsaka ett undantag.
En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.
Se även
Gäller för
StreamWriter(Stream, Encoding)
Initierar en ny instans av StreamWriter klassen för den angivna strömmen med hjälp av den angivna kodningen och standardbuffertstorleken.
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)
Parametrar
- stream
- Stream
Dataströmmen att skriva till.
- encoding
- Encoding
Teckenkodningen som ska användas.
Undantag
stream eller encoding är null.
stream är inte skrivbar.
Exempel
I följande exempel visas den här konstruktorn.
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
Kommentarer
Den här konstruktorn initierar Encoding egenskapen med hjälp av kodningsparametern och BaseStream egenskapen med hjälp av strömparametern. Strömmens position återställs inte. Mer information finns i Encoding.
Objektet StreamWriter anropar Dispose() det angivna Stream objektet när StreamWriter.Dispose det anropas.
Caution
När du kompilerar en uppsättning tecken med en viss kulturell inställning och hämtar samma tecken med en annan kulturell inställning kanske tecknen inte kan tolkas och kan orsaka ett undantag.
En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.
Se även
Gäller för
StreamWriter(String, Boolean)
Initierar en ny instans av StreamWriter klassen för den angivna filen med hjälp av standardkodning och buffertstorlek. Om filen finns kan den antingen skrivas över eller läggas till. Om filen inte finns skapar konstruktorn en ny fil.
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)
Parametrar
- path
- String
Den fullständiga filsökvägen att skriva till.
- append
- Boolean
true för att lägga till data i filen; false för att skriva över filen. Om den angivna filen inte finns har den här parametern ingen effekt och konstruktorn skapar en ny fil.
Undantag
Åtkomst avslås.
path är tom.
-eller-
path innehåller namnet på en systemenhet (com1, com2 och så vidare).
path är null.
Den angivna sökvägen är ogiltig (den finns till exempel på en ommappad enhet).
path innehåller en felaktig eller ogiltig syntax för filnamn, katalognamn eller volymetikettsyntax.
Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.
Anroparen har inte den behörighet som krävs.
Exempel
Följande kodexempel visar den här konstruktorn.
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
Kommentarer
Den här konstruktorn skapar en StreamWriter med UTF-8-kodning utan en Byte-Order Mark (BOM), så dess GetPreamble metod returnerar en tom bytematris. Utf-8-standardkodningen för den här konstruktorn genererar ett undantag på ogiltiga byte. Det här beteendet skiljer sig från det beteende som tillhandahålls av kodningsobjektet Encoding.UTF8 i egenskapen. Om du vill ange en strukturlista och avgöra om ett undantag genereras på ogiltiga byte använder du en konstruktor som accepterar ett kodningsobjekt som en parameter, till exempel StreamWriter(String, Boolean, Encoding).
Parametern path kan vara ett filnamn, inklusive en fil på en UNC-resurs (Universal Naming Convention).
Parametern måste inte vara en fil som lagras på disken. Den path kan vara en del av ett system som stöder åtkomst med hjälp av strömmar.
Caution
När du kompilerar en uppsättning tecken med en viss kulturell inställning och hämtar samma tecken med en annan kulturell inställning kanske tecknen inte kan tolkas och kan orsaka ett undantag.
En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.
Se även
Gäller för
StreamWriter(Stream, Encoding, Int32)
Initierar en ny instans av StreamWriter klassen för den angivna dataströmmen med den angivna kodnings- och buffertstorleken.
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)
Parametrar
- stream
- Stream
Dataströmmen att skriva till.
- encoding
- Encoding
Teckenkodningen som ska användas.
- bufferSize
- Int32
Buffertstorleken, i tecken.
Undantag
stream eller encoding är null.
bufferSize är mindre än eller lika med noll, förutom -1, vilket är tillåtet att ange standardbuffertstorleken.
stream är inte skrivbar.
Exempel
I följande exempel visas den här konstruktorn.
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
Kommentarer
Den här konstruktorn initierar Encoding egenskapen med hjälp av parametern encoding och egenskapen BaseStream med hjälp av parametern stream . Strömmens position återställs inte. Mer information finns i Encoding.
Objektet StreamWriter anropar Dispose() det angivna Stream objektet när StreamWriter.Dispose det anropas.
Caution
När du kompilerar en uppsättning tecken med en viss kulturell inställning och hämtar samma tecken med en annan kulturell inställning kanske tecknen inte kan tolkas och kan orsaka ett undantag.
En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.
Se även
Gäller för
StreamWriter(String, Boolean, Encoding)
Initierar en ny instans av StreamWriter klassen för den angivna filen med hjälp av den angivna kodningen och standardbuffertstorleken. Om filen finns kan den antingen skrivas över eller läggas till. Om filen inte finns skapar konstruktorn en ny fil.
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)
Parametrar
- path
- String
Den fullständiga filsökvägen att skriva till.
- append
- Boolean
true för att lägga till data i filen; false för att skriva över filen. Om den angivna filen inte finns har den här parametern ingen effekt och konstruktorn skapar en ny fil.
- encoding
- Encoding
Teckenkodningen som ska användas.
Undantag
Åtkomst avslås.
path är tom.
-eller-
path innehåller namnet på en systemenhet (com1, com2 och så vidare).
path är null.
Den angivna sökvägen är ogiltig (den finns till exempel på en ommappad enhet).
path innehåller en felaktig eller ogiltig syntax för filnamn, katalognamn eller volymetikettsyntax.
Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.
Anroparen har inte den behörighet som krävs.
Exempel
I följande exempel visas den här konstruktorn.
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
Kommentarer
Den här konstruktorn initierar Encoding egenskapen med hjälp av kodningsparametern. Mer information finns i Encoding.
path kan vara ett filnamn, inklusive en fil på en UNC-resurs (Universal Naming Convention).
path krävs inte vara en fil som lagras på disken. Det kan vara vilken del som helst av ett system som stöder åtkomst via strömmar.
Caution
När du kompilerar en uppsättning tecken med en viss kulturell inställning och hämtar samma tecken med en annan kulturell inställning kanske tecknen inte kan tolkas och kan orsaka ett undantag.
En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.
Se även
Gäller för
StreamWriter(Stream, Encoding, Int32, Boolean)
Initierar en ny instans av StreamWriter klassen för den angivna dataströmmen med den angivna kodnings- och buffertstorleken, och om du vill kan du lämna strömmen öppen.
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)
Parametrar
- stream
- Stream
Dataströmmen att skriva till.
- encoding
- Encoding
Teckenkodningen som ska användas.
- bufferSize
- Int32
Buffertstorleken, i tecken.
- leaveOpen
- Boolean
true för att lämna strömmen öppen när objektet StreamWriter har kasserats, falseannars .
Undantag
stream eller encoding är null.
bufferSize är mindre än eller lika med noll, förutom -1, vilket är tillåtet att ange standardbuffertstorleken.
stream är inte skrivbar.
Exempel
I följande exempel visas den här konstruktorn.
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
Kommentarer
Om du inte anger parametern leaveOpen till trueanropas Dispose()StreamWriter objektet på det angivna Stream objektet när StreamWriter.Dispose det anropas.
Den här konstruktorn initierar Encoding egenskapen med hjälp av parametern encoding och initierar BaseStream egenskapen med hjälp av parametern stream . Strömmens position återställs inte. Mer information finns i egenskapen Encoding .
Caution
När du kompilerar en uppsättning tecken med en viss kulturell inställning och hämtar samma tecken med en annan kulturell inställning kanske tecknen inte kan tolkas och kan orsaka ett undantag.
Gäller för
StreamWriter(String, Boolean, Encoding, Int32)
Initierar en ny instans av StreamWriter klassen för den angivna filen på den angivna sökvägen med den angivna kodnings- och buffertstorleken. Om filen finns kan den antingen skrivas över eller läggas till. Om filen inte finns skapar konstruktorn en ny fil.
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)
Parametrar
- path
- String
Den fullständiga filsökvägen att skriva till.
- append
- Boolean
true för att lägga till data i filen; false för att skriva över filen. Om den angivna filen inte finns har den här parametern ingen effekt och konstruktorn skapar en ny fil.
- encoding
- Encoding
Teckenkodningen som ska användas.
- bufferSize
- Int32
Buffertstorleken, i tecken.
Undantag
path är en tom sträng ("").
-eller-
path innehåller namnet på en systemenhet (com1, com2 och så vidare).
path eller encoding är null.
bufferSize är mindre än eller lika med noll, förutom -1, vilket är tillåtet att ange standardbuffertstorleken.
path innehåller en felaktig eller ogiltig syntax för filnamn, katalognamn eller volymetikettsyntax.
Anroparen har inte den behörighet som krävs.
Åtkomst avslås.
Den angivna sökvägen är ogiltig (den finns till exempel på en ommappad enhet).
Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.
Exempel
I följande exempel visas den här konstruktorn.
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
Kommentarer
Den här konstruktorn initierar Encoding egenskapen med hjälp av kodningsparametern. Mer information finns i Encoding.
path kan vara ett filnamn, inklusive en fil på en UNC-resurs (Universal Naming Convention).
path krävs inte vara en fil som lagras på disken. Det kan vara vilken del som helst av ett system som stöder åtkomst via strömmar.
Caution
När du kompilerar en uppsättning tecken med en viss kulturell inställning och hämtar samma tecken med en annan kulturell inställning kanske tecknen inte kan tolkas och kan orsaka ett undantag.
En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.