Sdílet prostřednictvím


StreamWriter Konstruktory

Definice

Inicializuje novou instanci StreamWriter třídy .

Přetížení

StreamWriter(Stream)

Inicializuje novou instanci StreamWriter třídy pro zadaný datový proud pomocí kódování UTF-8 a výchozí velikosti vyrovnávací paměti.

StreamWriter(String)

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí výchozího kódování a velikosti vyrovnávací paměti.

StreamWriter(Stream, Encoding)

Inicializuje novou instanci StreamWriter třídy pro zadaný datový proud pomocí zadaného kódování a výchozí velikosti vyrovnávací paměti.

StreamWriter(String, Boolean)

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí výchozího kódování a velikosti vyrovnávací paměti. Pokud soubor existuje, může být přepsán nebo připojen k. Pokud soubor neexistuje, tento konstruktor vytvoří nový soubor.

StreamWriter(String, FileStreamOptions)

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí výchozího kódování a konfiguruje se zadaným FileStreamOptions objektem.

StreamWriter(Stream, Encoding, Int32)

Inicializuje novou instanci StreamWriter třídy pro zadaný datový proud pomocí zadaného kódování a velikosti vyrovnávací paměti.

StreamWriter(String, Boolean, Encoding)

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí zadaného kódování a výchozí velikosti vyrovnávací paměti. Pokud soubor existuje, může být přepsán nebo připojen k. Pokud soubor neexistuje, tento konstruktor vytvoří nový soubor.

StreamWriter(String, Encoding, FileStreamOptions)

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí zadaného kódování a nakonfigurované s zadaným FileStreamOptions objektem.

StreamWriter(Stream, Encoding, Int32, Boolean)

Inicializuje novou instanci StreamWriter třídy pro zadaný datový proud pomocí zadaného kódování a velikosti vyrovnávací paměti a volitelně ponechá datový proud otevřený.

StreamWriter(String, Boolean, Encoding, Int32)

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor v zadané cestě pomocí zadaného kódování a velikosti vyrovnávací paměti. Pokud soubor existuje, může být přepsán nebo připojen k. Pokud soubor neexistuje, tento konstruktor vytvoří nový soubor.

StreamWriter(Stream)

Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný datový proud pomocí kódování UTF-8 a výchozí velikosti vyrovnávací paměti.

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)

Parametry

stream
Stream

Datový proud, do který chcete zapisovat.

Výjimky

stream není možné zapisovat.

stream je null.

Příklady

Následující příklad kódu ukazuje tento konstruktor.

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

Poznámky

Tento konstruktor vytvoří kód s kódováním StreamWriter UTF-8 bez značky Byte-Order (BOM), takže jeho GetPreamble metoda vrátí prázdné bajtové pole. Výchozí kódování UTF-8 pro tento konstruktor vyvolá výjimku pro neplatné bajty. Toto chování se liší od chování poskytovaného objektem kódování ve Encoding.UTF8 vlastnosti. Chcete-li určit, zda je vyvolána výjimka u neplatných bajtů, použijte konstruktor, který přijímá objekt kódování jako parametr, například StreamWriter. Vlastnost BaseStream se inicializuje pomocí parametru stream . Pozice datového proudu není resetovaná.

Objekt StreamWriter zavolá Dispose() zadaný Stream objekt při StreamWriter.Dispose volání.

Upozornění

Provedete-li kompilaci sady znaků s konkrétním jazykovým nastavením a načtete-li tytéž znaky s jiným jazykovým nastavením, je možné, že znaky nebude možné interpretovat, což může způsobit vygenerování výjimky.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

Platí pro

StreamWriter(String)

Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí výchozího kódování a velikosti vyrovnávací paměti.

public:
 StreamWriter(System::String ^ path);
public StreamWriter (string path);
new System.IO.StreamWriter : string -> System.IO.StreamWriter
Public Sub New (path As String)

Parametry

path
String

Úplná cesta k souboru, do které se má zapisovat. path může být název souboru.

Výjimky

Přístup byl zamítnut.

path je prázdný řetězec ("").

-nebo-

path obsahuje název systémového zařízení (com1, com2 atd.).

path je null.

Zadaná cesta je neplatná (například je na nezmapované jednotce).

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

path obsahuje nesprávnou nebo neplatnou syntaxi názvu souboru, názvu adresáře nebo syntaxe popisku svazku.

Volající nemá požadované oprávnění.

Příklady

Následující příklad kódu ukazuje tento konstruktor.

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

Poznámky

Tento konstruktor vytvoří kód s kódováním StreamWriter UTF-8 bez značky Byte-Order (BOM), takže jeho GetPreamble metoda vrátí prázdné bajtové pole. Výchozí kódování UTF-8 pro tento konstruktor vyvolá výjimku pro neplatné bajty. Toto chování se liší od chování poskytovaného objektem kódování ve Encoding.UTF8 vlastnosti. Chcete-li zadat kusovník a určit, zda je vyvolána výjimka u neplatných bajtů, použijte konstruktor, který přijímá objekt kódování jako parametr, například StreamWriter(String, Boolean, Encoding).

Parametr path může být název souboru, včetně souboru ve sdílené složce UNC (Universal Naming Convention). Pokud soubor existuje, je přepsán; v opačném případě se vytvoří nový soubor.

Parametr path nemusí být soubor uložený na disku. Může se jednat o libovolnou část systému, která podporuje přístup pomocí datových proudů.

Upozornění

Provedete-li kompilaci sady znaků s konkrétním jazykovým nastavením a načtete-li tytéž znaky s jiným jazykovým nastavením, je možné, že znaky nebude možné interpretovat, což může způsobit vygenerování výjimky.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

Platí pro

StreamWriter(Stream, Encoding)

Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný datový proud pomocí zadaného kódování a výchozí velikosti vyrovnávací paměti.

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)

Parametry

stream
Stream

Datový proud, do který chcete zapisovat.

encoding
Encoding

Kódování znaků, které se má použít.

Výjimky

stream nebo encoding je null.

stream není možné zapisovat.

Příklady

Následující příklad ukazuje tento konstruktor.

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

Poznámky

Tento konstruktor inicializuje Encoding vlastnost pomocí parametru kódování a BaseStream vlastnost pomocí parametru streamu. Pozice datového proudu není resetovaná. Další informace najdete v tématu Encoding.

Objekt StreamWriter zavolá Dispose() zadaný Stream objekt při StreamWriter.Dispose volání.

Upozornění

Když zkompilujete sadu znaků s určitým kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, nemusí být znaky interpretovatelné a může způsobit vyvolání výjimky.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

Platí pro

StreamWriter(String, Boolean)

Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí výchozího kódování a velikosti vyrovnávací paměti. Pokud soubor existuje, může být přepsán nebo připojen k. Pokud soubor neexistuje, tento konstruktor vytvoří nový soubor.

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)

Parametry

path
String

Úplná cesta k souboru, do které se má zapisovat.

append
Boolean

true připojit data do souboru; false soubor přepíšete. Pokud zadaný soubor neexistuje, nemá tento parametr žádný vliv a konstruktor vytvoří nový soubor.

Výjimky

Přístup byl zamítnut.

path je prázdný.

-nebo-

path obsahuje název systémového zařízení (com1, com2 atd.).

path je null.

Zadaná cesta je neplatná (například je na nezmapované jednotce).

path obsahuje nesprávnou nebo neplatnou syntaxi názvu souboru, názvu adresáře nebo syntaxe popisku svazku.

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

Volající nemá požadované oprávnění.

Příklady

Následující příklad kódu ukazuje tento konstruktor.

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

Poznámky

Tento konstruktor vytvoří kód s kódováním StreamWriter UTF-8 bez značky Byte-Order (BOM), takže jeho GetPreamble metoda vrátí prázdné bajtové pole. Výchozí kódování UTF-8 pro tento konstruktor vyvolá výjimku pro neplatné bajty. Toto chování se liší od chování poskytovaného objektem kódování ve Encoding.UTF8 vlastnosti. Chcete-li zadat kusovník a určit, zda je vyvolána výjimka u neplatných bajtů, použijte konstruktor, který přijímá objekt kódování jako parametr, například StreamWriter(String, Boolean, Encoding).

Parametr path může být název souboru, včetně souboru ve sdílené složce UNC (Universal Naming Convention).

Parametr path nemusí být soubor uložený na disku. Může se jednat o libovolnou část systému, která podporuje přístup pomocí datových proudů.

Upozornění

Když zkompilujete sadu znaků s určitým kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, nemusí být znaky interpretovatelné a může způsobit vyvolání výjimky.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

Platí pro

StreamWriter(String, FileStreamOptions)

Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí výchozího kódování a konfiguruje se zadaným FileStreamOptions objektem.

public:
 StreamWriter(System::String ^ path, System::IO::FileStreamOptions ^ options);
public StreamWriter (string path, System.IO.FileStreamOptions options);
new System.IO.StreamWriter : string * System.IO.FileStreamOptions -> System.IO.StreamWriter
Public Sub New (path As String, options As FileStreamOptions)

Parametry

path
String

Úplná cesta k souboru, do které se má zapisovat.

options
FileStreamOptions

Objekt, který určuje možnosti konfigurace pro základní FileStreamobjekt .

Výjimky

options je null .

stream není možné zapisovat.

Viz také

Platí pro

StreamWriter(Stream, Encoding, Int32)

Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný datový proud pomocí zadaného kódování a velikosti vyrovnávací paměti.

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)

Parametry

stream
Stream

Datový proud, do který chcete zapisovat.

encoding
Encoding

Kódování znaků, které se má použít.

bufferSize
Int32

Velikost vyrovnávací paměti v bajtech.

Výjimky

stream nebo encoding je null.

bufferSize je negativní.

stream není možné zapisovat.

Příklady

Následující příklad ukazuje tento konstruktor.

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

Poznámky

Tento konstruktor inicializuje Encoding vlastnost pomocí parametru encoding a BaseStream vlastnost pomocí parametru stream . Pozice datového proudu není resetovaná. Další informace najdete v tématu Encoding.

Objekt StreamWriter zavolá Dispose() zadaný Stream objekt při StreamWriter.Dispose volání.

Upozornění

Když zkompilujete sadu znaků s určitým kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, nemusí být znaky interpretovatelné a může způsobit vyvolání výjimky.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

Platí pro

StreamWriter(String, Boolean, Encoding)

Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí zadaného kódování a výchozí velikosti vyrovnávací paměti. Pokud soubor existuje, může být přepsán nebo připojen k. Pokud soubor neexistuje, tento konstruktor vytvoří nový soubor.

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)

Parametry

path
String

Úplná cesta k souboru, do které se má zapisovat.

append
Boolean

true připojit data do souboru; false soubor přepíšete. Pokud zadaný soubor neexistuje, nemá tento parametr žádný vliv a konstruktor vytvoří nový soubor.

encoding
Encoding

Kódování znaků, které se má použít.

Výjimky

Přístup byl zamítnut.

path je prázdný.

-nebo-

path obsahuje název systémového zařízení (com1, com2 atd.).

path je null.

Zadaná cesta je neplatná (například je na nezmapované jednotce).

path obsahuje nesprávnou nebo neplatnou syntaxi názvu souboru, názvu adresáře nebo syntaxe popisku svazku.

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

Volající nemá požadované oprávnění.

Příklady

Následující příklad ukazuje tento konstruktor.

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

Poznámky

Tento konstruktor inicializuje Encoding vlastnost pomocí parametru kódování. Další informace najdete v tématu Encoding.

path může být název souboru, včetně souboru ve sdílené složce UNC (Universal Naming Convention).

path nemusí být souborem uloženým na disku; může to být libovolná část systému, která podporuje přístup prostřednictvím datových proudů.

Upozornění

Když zkompilujete sadu znaků s určitým kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, nemusí být znaky interpretovatelné a může způsobit vyvolání výjimky.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

Platí pro

StreamWriter(String, Encoding, FileStreamOptions)

Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí zadaného kódování a nakonfigurované s zadaným FileStreamOptions objektem.

public:
 StreamWriter(System::String ^ path, System::Text::Encoding ^ encoding, System::IO::FileStreamOptions ^ options);
public StreamWriter (string path, System.Text.Encoding encoding, System.IO.FileStreamOptions options);
new System.IO.StreamWriter : string * System.Text.Encoding * System.IO.FileStreamOptions -> System.IO.StreamWriter
Public Sub New (path As String, encoding As Encoding, options As FileStreamOptions)

Parametry

path
String

Úplná cesta k souboru, do které se má zapisovat.

encoding
Encoding

Kódování znaků, které se má použít.

options
FileStreamOptions

Objekt, který určuje možnosti konfigurace pro základní FileStreamobjekt .

Výjimky

options je null .

stream není možné zapisovat.

Viz také

Platí pro

StreamWriter(Stream, Encoding, Int32, Boolean)

Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný datový proud pomocí zadaného kódování a velikosti vyrovnávací paměti a volitelně ponechá datový proud otevřený.

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);
public StreamWriter (System.IO.Stream stream, System.Text.Encoding? encoding = default, int bufferSize = -1, bool leaveOpen = false);
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)
Public Sub New (stream As Stream, Optional encoding As Encoding = Nothing, Optional bufferSize As Integer = -1, Optional leaveOpen As Boolean = false)

Parametry

stream
Stream

Datový proud, do který chcete zapisovat.

encoding
Encoding

Kódování znaků, které se má použít.

bufferSize
Int32

Velikost vyrovnávací paměti v bajtech.

leaveOpen
Boolean

true po odstranění objektu StreamWriter ponecháte datový proud otevřený. V opačném případě false.

Výjimky

stream nebo encoding je null.

bufferSize je negativní.

stream není možné zapisovat.

Příklady

Následující příklad ukazuje tento konstruktor.

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

Poznámky

Pokud nenastavíte leaveOpen parametr na truehodnotu , StreamWriter objekt Dispose() zavolá zadaný Stream objekt při StreamWriter.Dispose volání.

Tento konstruktor inicializuje Encoding vlastnost pomocí parametru encoding a inicializuje BaseStream vlastnost pomocí parametru stream . Pozice datového proudu není resetovaná. Další informace najdete ve Encoding vlastnosti .

Upozornění

Když zkompilujete sadu znaků s určitým kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, nemusí být znaky interpretovatelné a může způsobit vyvolání výjimky.

Platí pro

StreamWriter(String, Boolean, Encoding, Int32)

Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs
Zdroj:
StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor v zadané cestě pomocí zadaného kódování a velikosti vyrovnávací paměti. Pokud soubor existuje, může být přepsán nebo připojen k. Pokud soubor neexistuje, tento konstruktor vytvoří nový soubor.

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)

Parametry

path
String

Úplná cesta k souboru, do které se má zapisovat.

append
Boolean

true připojit data do souboru; false pro přepsání souboru. Pokud zadaný soubor neexistuje, nemá tento parametr žádný vliv a konstruktor vytvoří nový soubor.

encoding
Encoding

Kódování znaků, které se mají použít.

bufferSize
Int32

Velikost vyrovnávací paměti v bajtech.

Výjimky

path je prázdný řetězec ("").

-nebo-

path obsahuje název systémového zařízení (com1, com2 atd.).

path nebo encoding je null.

bufferSize je negativní.

path obsahuje nesprávnou nebo neplatnou syntaxi názvu souboru, názvu adresáře nebo popisku svazku.

Volající nemá požadované oprávnění.

Přístup byl zamítnut.

Zadaná cesta je neplatná (například je na nenamapované jednotce).

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

Příklady

Následující příklad ukazuje tento konstruktor.

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

Poznámky

Tento konstruktor inicializuje Encoding vlastnost pomocí parametru kódování. Další informace najdete v tématu Encoding.

path může být název souboru, včetně souboru ve sdílené složce UNC (Universal Naming Convention).

path nemusí být soubor uložený na disku; může to být libovolná část systému, která podporuje přístup prostřednictvím datových proudů.

Upozornění

Když kompilujete sadu znaků s konkrétním kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, znaky nemusí být interpretovatelné a mohou způsobit výjimku.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

Platí pro