StreamWriter Konstruktory

Definice

Obor názvů:: System.IO

Sestavení:: mscorlib.dll, System.IO.dll

Sestavení:: netstandard.dll, System.Runtime.dll

Sestavení:: System.IO.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í

Name	Description
StreamWriter(Stream)	Inicializuje novou instanci StreamWriter třídy pro zadaný datový proud pomocí kódování UTF-8 a výchozí velikost vyrovnávací paměti.
StreamWriter(String)	Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí výchozí kódování a velikost 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í velikost vyrovnávací paměti.
StreamWriter(String, Boolean)	Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí výchozí kódování a velikost vyrovnávací paměti. Pokud soubor existuje, může být přepsán nebo připojen. 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 nakonfigurovaný se zadaným FileStreamOptions objektem.
StreamWriter(Stream, Encoding, Int32)	Inicializuje novou instanci StreamWriter třídy pro zadaný datový proud pomocí zadané 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. 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é se zadaným FileStreamOptions objektem.
StreamWriter(Stream, Encoding, Int32, Boolean)	Inicializuje novou instanci StreamWriter třídy pro zadaný datový proud pomocí zadané kódování a velikost vyrovnávací paměti a volitelně ponechá stream otevřený.
StreamWriter(String, Boolean, Encoding, Int32)	Inicializuje novou instanci StreamWriter třídy pro zadaný soubor v zadané cestě pomocí zadané kódování a velikosti vyrovnávací paměti. Pokud soubor existuje, může být přepsán nebo připojen. Pokud soubor neexistuje, tento konstruktor vytvoří nový soubor.

StreamWriter(Stream)

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

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í velikost 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ý se má zapisovat.

Výjimky

ArgumentException

stream není zapisovatelný.

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ří StreamWriter kódování UTF-8 bez Byte-Order Mark (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 u neplatných bajtů. Toto chování se liší od chování poskytované objektem kódování ve Encoding.UTF8 vlastnosti. Chcete-li určit, zda je výjimka vyvolána 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í resetována.

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

Upozornění

Když zkompilujete sadu znaků s konkrétním kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, nemusí být interpretovatelné a může dojít k výjimce.

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

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí výchozí kódování a velikost 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 to být název souboru.

Výjimky

UnauthorizedAccessException

Přístup byl odepřen.

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 nemapované 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ří StreamWriter kódování UTF-8 bez Byte-Order Mark (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 u neplatných bajtů. Toto chování se liší od chování poskytované objektem kódování ve Encoding.UTF8 vlastnosti. Chcete-li zadat kusovník a určit, zda je vyvolána výjimka pro neplatné bajty, použijte konstruktor, který přijímá objekt kódování jako parametr, například StreamWriter(String, Boolean, Encoding).

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

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

Upozornění

Když zkompilujete sadu znaků s konkrétním kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, nemusí být interpretovatelné a může dojít k výjimce.

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

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í velikost vyrovnávací paměti.

public:
 StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding);

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ý se má zapisovat.

encoding: Encoding

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

Výjimky

ArgumentNullException

stream nebo encoding je null.

ArgumentException

stream není zapisovatelný.

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 stream. Pozice datového proudu není resetována. Další informace najdete v tématu Encoding.

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

Upozornění

Když zkompilujete sadu znaků s konkrétním kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, nemusí být interpretovatelné a může dojít k výjimce.

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

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí výchozí kódování a velikost vyrovnávací paměti. Pokud soubor existuje, může být přepsán nebo připojen. 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řipojení dat k souboru; false k přepsání souboru. Pokud zadaný soubor neexistuje, tento parametr nemá žádný vliv a konstruktor vytvoří nový soubor.

Výjimky

UnauthorizedAccessException

Přístup byl odepřen.

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 nemapované 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ří StreamWriter kódování UTF-8 bez Byte-Order Mark (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 u neplatných bajtů. Toto chování se liší od chování poskytované objektem kódování ve Encoding.UTF8 vlastnosti. Chcete-li zadat kusovník a určit, zda je vyvolána výjimka pro neplatné bajty, použijte konstruktor, který přijímá objekt kódování jako parametr, například StreamWriter(String, Boolean, Encoding).

Parametrem 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 to být jakákoli část systému, která podporuje přístup pomocí datových proudů.

Upozornění

Když zkompilujete sadu znaků s konkrétním kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, nemusí být interpretovatelné a může dojít k výjimce.

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

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí výchozího kódování a nakonfigurovaný 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 podkladového FileStreamobjektu .

Výjimky

ArgumentNullException

options je null .

ArgumentException

path není zapisovatelný.

Viz také

Platí pro

StreamWriter(Stream, Encoding, Int32)

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný datový proud pomocí zadané 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);

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ý se má zapisovat.

encoding: Encoding

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

bufferSize: Int32

Velikost vyrovnávací paměti ve znaznachu.

Výjimky

ArgumentNullException

stream nebo encoding je null.

ArgumentOutOfRangeException

bufferSize je menší než nebo rovno nule, s výjimkou -1, což může znamenat výchozí velikost vyrovnávací paměti.

ArgumentException

stream není zapisovatelný.

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í encoding parametru BaseStream a vlastnost pomocí parametru stream . Pozice datového proudu není resetována. Další informace najdete v tématu Encoding.

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

Upozornění

Když zkompilujete sadu znaků s konkrétním kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, nemusí být interpretovatelné a může dojít k výjimce.

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

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. 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);

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řipojení dat k souboru; false k přepsání souboru. Pokud zadaný soubor neexistuje, tento parametr nemá žádný vliv a konstruktor vytvoří nový soubor.

encoding: Encoding

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

Výjimky

UnauthorizedAccessException

Přístup byl odepřen.

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 nemapované 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 není nutné, aby byl soubor uložený na disku; může být libovolnou součástí systému, který podporuje přístup prostřednictvím datových proudů.

Upozornění

Když zkompilujete sadu znaků s konkrétním kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, nemusí být interpretovatelné a může dojít k výjimce.

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

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor pomocí zadaného kódování a nakonfigurované se 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);

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 podkladového FileStreamobjektu .

Výjimky

ArgumentNullException

options je null .

ArgumentException

path není zapisovatelný.

Viz také

Platí pro

StreamWriter(Stream, Encoding, Int32, Boolean)

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný datový proud pomocí zadané kódování a velikost vyrovnávací paměti a volitelně ponechá stream 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ý se má zapisovat.

encoding: Encoding

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

bufferSize: Int32

Velikost vyrovnávací paměti ve znaznachu.

leaveOpen: Boolean

truenechat datový proud otevřený po odstranění objektuStreamWriter; v opačném případě . false

Výjimky

ArgumentNullException

stream nebo encoding je null.

ArgumentOutOfRangeException

bufferSize je menší než nebo rovno nule, s výjimkou -1, což může znamenat výchozí velikost vyrovnávací paměti.

ArgumentException

stream není zapisovatelný.

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 parametr na leaveOpentrue, StreamWriter objekt volá Dispose() 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í resetována. Další informace najdete v Encoding této vlastnosti.

Upozornění

Když zkompilujete sadu znaků s konkrétním kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, nemusí být interpretovatelné a může dojít k výjimce.

Platí pro

StreamWriter(String, Boolean, Encoding, Int32)

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Zdroj:: StreamWriter.cs

Inicializuje novou instanci StreamWriter třídy pro zadaný soubor v zadané cestě pomocí zadané kódování a velikosti vyrovnávací paměti. Pokud soubor existuje, může být přepsán nebo připojen. 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);

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řipojení dat k souboru; false k přepsání souboru. Pokud zadaný soubor neexistuje, tento parametr nemá žádný vliv a konstruktor vytvoří nový soubor.

encoding: Encoding

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

bufferSize: Int32

Velikost vyrovnávací paměti ve znaznachu.

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 menší než nebo rovno nule, s výjimkou -1, což může znamenat výchozí velikost vyrovnávací paměti.

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í.

UnauthorizedAccessException

Přístup byl odepřen.

DirectoryNotFoundException

Zadaná cesta je neplatná (například je na nemapované 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 není nutné, aby byl soubor uložený na disku; může být libovolnou součástí systému, který podporuje přístup prostřednictvím datových proudů.

Upozornění

Když zkompilujete sadu znaků s konkrétním kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, nemusí být interpretovatelné a může dojít k výjimce.

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

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?

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

Váš názor