StreamWriter Konstruktory

Reference

Definice

Obor názvů:: System.IO

Sestavení:: System.IO.dll

Sestavení:: System.Runtime.dll

Sestavení:: System.Runtime.Extensions.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

ArgumentException

stream není možné zapisovat.

ArgumentNullException

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

UnauthorizedAccessException

Přístup byl zamítnut.

ArgumentException

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

-nebo-

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

ArgumentNullException

path je null.

DirectoryNotFoundException

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

PathTooLongException

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

IOException

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

SecurityException

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í

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

ArgumentNullException

stream nebo encoding je null.

ArgumentException

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

UnauthorizedAccessException

Přístup byl zamítnut.

ArgumentException

path je prázdný.

-nebo-

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

ArgumentNullException

path je null.

DirectoryNotFoundException

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

IOException

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

PathTooLongException

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

SecurityException

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í

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

ArgumentNullException

options je null .

ArgumentException

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

ArgumentNullException

stream nebo encoding je null.

ArgumentOutOfRangeException

bufferSize je negativní.

ArgumentException

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í

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

UnauthorizedAccessException

Přístup byl zamítnut.

ArgumentException

path je prázdný.

-nebo-

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

ArgumentNullException

path je null.

DirectoryNotFoundException

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

IOException

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

PathTooLongException

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

SecurityException

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í

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

ArgumentNullException

options je null .

ArgumentException

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

ArgumentNullException

stream nebo encoding je null.

ArgumentOutOfRangeException

bufferSize je negativní.

ArgumentException

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í

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

ArgumentException

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

-nebo-

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

ArgumentNullException

path nebo encoding je null.

ArgumentOutOfRangeException

bufferSize je negativní.

IOException

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

SecurityException

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

UnauthorizedAccessException

Přístup byl zamítnut.

DirectoryNotFoundException

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

PathTooLongException

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

Sdílet prostřednictvím

StreamWriter Konstruktory

Definice

Přetížení

StreamWriter(Stream)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

StreamWriter(String)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

StreamWriter(Stream, Encoding)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

StreamWriter(String, Boolean)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

StreamWriter(String, FileStreamOptions)

Parametry

Výjimky

Viz také

Platí pro

StreamWriter(Stream, Encoding, Int32)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

StreamWriter(String, Boolean, Encoding)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

StreamWriter(String, Encoding, FileStreamOptions)

Parametry

Výjimky

Viz také

Platí pro

StreamWriter(Stream, Encoding, Int32, Boolean)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

StreamWriter(String, Boolean, Encoding, Int32)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály