StreamWriter Konstruktory

Odwołanie

Definicja

Przestrzeń nazw:: System.IO

Zestaw:: System.IO.dll

Zestaw:: System.Runtime.dll

Zestaw:: System.Runtime.Extensions.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Inicjuje nowe wystąpienie klasy StreamWriter.

Przeciążenia

StreamWriter(Stream)	Inicjuje StreamWriter nowe wystąpienie klasy dla określonego strumienia przy użyciu kodowania UTF-8 i domyślnego rozmiaru buforu.
StreamWriter(String)	Inicjuje StreamWriter nowe wystąpienie klasy dla określonego pliku przy użyciu domyślnego kodowania i rozmiaru buforu.
StreamWriter(Stream, Encoding)	Inicjuje StreamWriter nowe wystąpienie klasy dla określonego strumienia przy użyciu określonego kodowania i domyślnego rozmiaru buforu.
StreamWriter(String, Boolean)	Inicjuje StreamWriter nowe wystąpienie klasy dla określonego pliku przy użyciu domyślnego kodowania i rozmiaru buforu. Jeśli plik istnieje, można go zastąpić lub dołączyć do niego. Jeśli plik nie istnieje, ten konstruktor tworzy nowy plik.
StreamWriter(String, FileStreamOptions)	Inicjuje StreamWriter nowe wystąpienie klasy dla określonego pliku przy użyciu kodowania domyślnego i skonfigurowane z określonym FileStreamOptions obiektem.
StreamWriter(Stream, Encoding, Int32)	Inicjuje StreamWriter nowe wystąpienie klasy dla określonego strumienia przy użyciu określonego kodowania i rozmiaru buforu.
StreamWriter(String, Boolean, Encoding)	Inicjuje StreamWriter nowe wystąpienie klasy dla określonego pliku przy użyciu określonego kodowania i domyślnego rozmiaru buforu. Jeśli plik istnieje, można go zastąpić lub dołączyć do niego. Jeśli plik nie istnieje, ten konstruktor tworzy nowy plik.
StreamWriter(String, Encoding, FileStreamOptions)	Inicjuje nowe wystąpienie StreamWriter klasy dla określonego pliku przy użyciu określonego kodowania i skonfigurowane przy użyciu określonego FileStreamOptions obiektu.
StreamWriter(Stream, Encoding, Int32, Boolean)	Inicjuje StreamWriter nowe wystąpienie klasy dla określonego strumienia przy użyciu określonego rozmiaru kodowania i buforu, a opcjonalnie pozostawia otwarty strumień.
StreamWriter(String, Boolean, Encoding, Int32)	Inicjuje StreamWriter nowe wystąpienie klasy dla określonego pliku w określonej ścieżce przy użyciu określonego kodowania i rozmiaru buforu. Jeśli plik istnieje, można go zastąpić lub dołączyć do niego. Jeśli plik nie istnieje, ten konstruktor tworzy nowy plik.

StreamWriter(Stream)

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Inicjuje StreamWriter nowe wystąpienie klasy dla określonego strumienia przy użyciu kodowania UTF-8 i domyślnego rozmiaru buforu.

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

Strumień do zapisu.

Wyjątki

ArgumentException

stream nie jest zapisywalny.

ArgumentNullException

stream to null.

Przykłady

W poniższym przykładzie kodu pokazano ten 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

Uwagi

Ten konstruktor tworzy kodowanie StreamWriter UTF-8 bez znaku Byte-Order Mark (BOM), więc metoda GetPreamble zwraca pustą tablicę bajtów. Domyślne kodowanie UTF-8 dla tego konstruktora zgłasza wyjątek dla nieprawidłowych bajtów. To zachowanie różni się od zachowania udostępnianego przez obiekt kodowania we Encoding.UTF8 właściwości. Aby określić, czy wyjątek jest zgłaszany w nieprawidłowych bajtach, użyj konstruktora, który akceptuje obiekt kodowania jako parametr, taki jak StreamWriter. Właściwość BaseStream jest inicjowana przy użyciu parametru stream . Położenie strumienia nie jest resetowane.

Obiekt StreamWriter wywołuje Dispose() podany Stream obiekt, gdy StreamWriter.Dispose jest wywoływany.

Przestroga

Gdy zbiór znaków zostanie skompilowany z określonym ustawieniem kultury, po czym pobrany z użyciem innego ustawienia kultury, znaki mogą nie nadawać się do interpretacji i powodować zgłoszenie wyjątku.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

Dotyczy

StreamWriter(String)

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Inicjuje StreamWriter nowe wystąpienie klasy dla określonego pliku przy użyciu domyślnego kodowania i rozmiaru buforu.

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

Pełna ścieżka pliku do zapisu. path może być nazwą pliku.

Wyjątki

UnauthorizedAccessException

Odmowa dostępu.

ArgumentException

path jest pustym ciągiem ("").

-lub-

path zawiera nazwę urządzenia systemowego (com1, com2 itd.).

ArgumentNullException

path to null.

DirectoryNotFoundException

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niezamapowanym dysku).

PathTooLongException

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

IOException

path zawiera nieprawidłową lub nieprawidłową składnię nazwy pliku, nazwy katalogu lub składni etykiety woluminu.

SecurityException

Obiekt wywołujący nie posiada wymaganych uprawnień.

Przykłady

W poniższym przykładzie kodu pokazano ten 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

Uwagi

Ten konstruktor tworzy kodowanie StreamWriter UTF-8 bez znaku Byte-Order Mark (BOM), więc metoda GetPreamble zwraca pustą tablicę bajtów. Domyślne kodowanie UTF-8 dla tego konstruktora zgłasza wyjątek dla nieprawidłowych bajtów. To zachowanie różni się od zachowania udostępnianego przez obiekt kodowania we Encoding.UTF8 właściwości. Aby określić obiekt BOM i określić, czy wyjątek jest zgłaszany w nieprawidłowych bajtach, użyj konstruktora, który akceptuje obiekt kodowania jako parametr, taki jak StreamWriter(String, Boolean, Encoding).

Parametr path może być nazwą pliku, w tym plikiem w udziale Universal Naming Convention (UNC). Jeśli plik istnieje, zostanie zastąpiony; w przeciwnym razie zostanie utworzony nowy plik.

Parametr path nie jest wymagany do przechowywania pliku na dysku. Może to być dowolna część systemu obsługującego dostęp przy użyciu strumieni.

Przestroga

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

Dotyczy

StreamWriter(Stream, Encoding)

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Inicjuje StreamWriter nowe wystąpienie klasy dla określonego strumienia przy użyciu określonego kodowania i domyślnego rozmiaru buforu.

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

Strumień do zapisu.

encoding: Encoding

Kodowanie znaków do użycia.

Wyjątki

ArgumentNullException

stream lub encoding to null.

ArgumentException

stream nie jest zapisywalny.

Przykłady

W poniższym przykładzie pokazano ten 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

Uwagi

Ten konstruktor inicjuje Encoding właściwość przy użyciu parametru kodowania i BaseStream właściwość przy użyciu parametru strumienia. Położenie strumienia nie jest resetowane. Aby uzyskać dodatkowe informacje, zobacz Encoding.

Obiekt StreamWriter wywołuje Dispose() podany Stream obiekt, gdy StreamWriter.Dispose jest wywoływany.

Przestroga

Podczas kompilowania zestawu znaków z określonym ustawieniem kulturowym i pobierania tych samych znaków z innym ustawieniem kulturowym znaki mogą nie być interpretowane i mogą powodować zgłoszenie wyjątku.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

Dotyczy

StreamWriter(String, Boolean)

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Inicjuje StreamWriter nowe wystąpienie klasy dla określonego pliku przy użyciu domyślnego kodowania i rozmiaru buforu. Jeśli plik istnieje, można go zastąpić lub dołączyć do niego. Jeśli plik nie istnieje, ten konstruktor tworzy nowy plik.

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

Pełna ścieżka pliku do zapisu.

append: Boolean

true do dołączania danych do pliku; false aby zastąpić plik. Jeśli określony plik nie istnieje, ten parametr nie ma wpływu, a konstruktor tworzy nowy plik.

Wyjątki

UnauthorizedAccessException

Odmowa dostępu.

ArgumentException

path jest pusty.

-lub-

path zawiera nazwę urządzenia systemowego (com1, com2 itd.).

ArgumentNullException

path to null.

DirectoryNotFoundException

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niezamapowanym dysku).

IOException

path zawiera nieprawidłową lub nieprawidłową składnię nazwy pliku, nazwy katalogu lub składni etykiety woluminu.

PathTooLongException

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

SecurityException

Obiekt wywołujący nie posiada wymaganych uprawnień.

Przykłady

W poniższym przykładzie kodu pokazano ten 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

Uwagi

Ten konstruktor tworzy kodowanie StreamWriter UTF-8 bez znaku Byte-Order Mark (BOM), więc metoda GetPreamble zwraca pustą tablicę bajtów. Domyślne kodowanie UTF-8 dla tego konstruktora zgłasza wyjątek dla nieprawidłowych bajtów. To zachowanie różni się od zachowania udostępnianego przez obiekt kodowania we Encoding.UTF8 właściwości. Aby określić obiekt BOM i określić, czy wyjątek jest zgłaszany w nieprawidłowych bajtach, użyj konstruktora, który akceptuje obiekt kodowania jako parametr, taki jak StreamWriter(String, Boolean, Encoding).

Parametr path może być nazwą pliku, w tym plikiem w udziale Universal Naming Convention (UNC).

Parametr path nie jest wymagany do przechowywania pliku na dysku. Może to być dowolna część systemu obsługującego dostęp przy użyciu strumieni.

Przestroga

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

Dotyczy

StreamWriter(String, FileStreamOptions)

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Inicjuje StreamWriter nowe wystąpienie klasy dla określonego pliku przy użyciu kodowania domyślnego i skonfigurowane z określonym FileStreamOptions obiektem.

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

Pełna ścieżka pliku do zapisu.

options: FileStreamOptions

Obiekt, który określa opcje konfiguracji dla bazowego FileStreamobiektu .

Wyjątki

ArgumentNullException

options to null .

ArgumentException

stream nie jest zapisywalny.

Zobacz też

Dotyczy

StreamWriter(Stream, Encoding, Int32)

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Inicjuje StreamWriter nowe wystąpienie klasy dla określonego strumienia przy użyciu określonego kodowania i rozmiaru buforu.

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

Strumień do zapisu.

encoding: Encoding

Kodowanie znaków do użycia.

bufferSize: Int32

Rozmiar buforu w bajtach.

Wyjątki

ArgumentNullException

stream lub encoding to null.

ArgumentOutOfRangeException

bufferSize jest ujemna.

ArgumentException

stream nie jest zapisywalny.

Przykłady

W poniższym przykładzie pokazano ten 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

Uwagi

Ten konstruktor inicjuje Encoding właściwość przy użyciu parametru encoding i BaseStream właściwość przy użyciu parametru stream . Położenie strumienia nie jest resetowane. Aby uzyskać dodatkowe informacje, zobacz Encoding.

Obiekt StreamWriter wywołuje Dispose() podany Stream obiekt, gdy StreamWriter.Dispose jest wywoływany.

Przestroga

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

Dotyczy

StreamWriter(String, Boolean, Encoding)

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Inicjuje StreamWriter nowe wystąpienie klasy dla określonego pliku przy użyciu określonego kodowania i domyślnego rozmiaru buforu. Jeśli plik istnieje, można go zastąpić lub dołączyć do niego. Jeśli plik nie istnieje, ten konstruktor tworzy nowy plik.

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

Pełna ścieżka pliku do zapisu.

append: Boolean

true do dołączania danych do pliku; false aby zastąpić plik. Jeśli określony plik nie istnieje, ten parametr nie ma wpływu, a konstruktor tworzy nowy plik.

encoding: Encoding

Kodowanie znaków do użycia.

Wyjątki

UnauthorizedAccessException

Odmowa dostępu.

ArgumentException

path jest pusty.

-lub-

path zawiera nazwę urządzenia systemowego (com1, com2 itd.).

ArgumentNullException

path to null.

DirectoryNotFoundException

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niezamapowanym dysku).

IOException

path zawiera nieprawidłową lub nieprawidłową składnię nazwy pliku, nazwy katalogu lub składni etykiety woluminu.

PathTooLongException

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

SecurityException

Obiekt wywołujący nie posiada wymaganych uprawnień.

Przykłady

W poniższym przykładzie pokazano ten 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

Uwagi

Ten konstruktor inicjuje Encoding właściwość przy użyciu parametru kodowania. Aby uzyskać dodatkowe informacje, zobacz Encoding.

path może być nazwą pliku, w tym plikiem w udziale Universal Naming Convention (UNC).

path nie musi być plikiem przechowywanym na dysku; może to być dowolna część systemu, która obsługuje dostęp za pośrednictwem strumieni.

Przestroga

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

Dotyczy

StreamWriter(String, Encoding, FileStreamOptions)

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Inicjuje nowe wystąpienie StreamWriter klasy dla określonego pliku przy użyciu określonego kodowania i skonfigurowane przy użyciu określonego FileStreamOptions obiektu.

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

Pełna ścieżka pliku do zapisu.

encoding: Encoding

Kodowanie znaków do użycia.

options: FileStreamOptions

Obiekt, który określa opcje konfiguracji dla bazowego FileStreamobiektu .

Wyjątki

ArgumentNullException

options to null .

ArgumentException

stream nie jest zapisywalny.

Zobacz też

Dotyczy

StreamWriter(Stream, Encoding, Int32, Boolean)

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Inicjuje StreamWriter nowe wystąpienie klasy dla określonego strumienia przy użyciu określonego rozmiaru kodowania i buforu, a opcjonalnie pozostawia otwarty strumień.

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

Strumień do zapisu.

encoding: Encoding

Kodowanie znaków do użycia.

bufferSize: Int32

Rozmiar buforu w bajtach.

leaveOpen: Boolean

true aby pozostawić strumień otwarty po usunięciu StreamWriter obiektu; w przeciwnym razie false.

Wyjątki

ArgumentNullException

stream lub encoding to null.

ArgumentOutOfRangeException

bufferSize jest ujemna.

ArgumentException

stream nie jest zapisywalny.

Przykłady

W poniższym przykładzie pokazano ten 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

Uwagi

Jeśli parametr nie zostanie ustawiony leaveOpen na true, StreamWriter obiekt wywołuje Dispose() podany Stream obiekt po StreamWriter.Dispose wywołaniu.

Ten konstruktor inicjuje Encoding właściwość przy użyciu parametru encoding i inicjuje BaseStream właściwość przy użyciu parametru stream . Położenie strumienia nie jest resetowane. Aby uzyskać dodatkowe informacje, zobacz Encoding właściwość .

Przestroga

Dotyczy

StreamWriter(String, Boolean, Encoding, Int32)

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Źródło:: StreamWriter.cs

Inicjuje StreamWriter nowe wystąpienie klasy dla określonego pliku w określonej ścieżce przy użyciu określonego kodowania i rozmiaru buforu. Jeśli plik istnieje, można go zastąpić lub dołączyć do niego. Jeśli plik nie istnieje, ten konstruktor tworzy nowy plik.

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

Pełna ścieżka pliku do zapisu.

append: Boolean

true do dołączania danych do pliku; false aby zastąpić plik. Jeśli określony plik nie istnieje, ten parametr nie ma wpływu, a konstruktor tworzy nowy plik.

encoding: Encoding

Kodowanie znaków do użycia.

bufferSize: Int32

Rozmiar buforu w bajtach.

Wyjątki

ArgumentException

path jest pustym ciągiem ("").

-lub-

path zawiera nazwę urządzenia systemowego (com1, com2 itd.).

ArgumentNullException

path lub encoding to null.

ArgumentOutOfRangeException

bufferSize jest ujemna.

IOException

path zawiera nieprawidłową lub nieprawidłową składnię nazwy pliku, nazwy katalogu lub składni etykiety woluminu.

SecurityException

Obiekt wywołujący nie posiada wymaganych uprawnień.

UnauthorizedAccessException

Odmowa dostępu.

DirectoryNotFoundException

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niezamapowanym dysku).

PathTooLongException

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

Przykłady

W poniższym przykładzie pokazano ten 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

Uwagi

Ten konstruktor inicjuje Encoding właściwość przy użyciu parametru kodowania. Aby uzyskać dodatkowe informacje, zobacz Encoding.

path może być nazwą pliku, w tym plikiem w udziale Universal Naming Convention (UNC).

path nie musi być plikiem przechowywanym na dysku; może to być dowolna część systemu, która obsługuje dostęp za pośrednictwem strumieni.

Przestroga

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

Dotyczy

StreamWriter Konstruktory

Definicja

Przeciążenia

StreamWriter(Stream)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

StreamWriter(String)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

StreamWriter(Stream, Encoding)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

StreamWriter(String, Boolean)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

StreamWriter(String, FileStreamOptions)

Parametry

Wyjątki

Zobacz też

Dotyczy

StreamWriter(Stream, Encoding, Int32)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

StreamWriter(String, Boolean, Encoding)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

StreamWriter(String, Encoding, FileStreamOptions)

Parametry

Wyjątki

Zobacz też

Dotyczy

StreamWriter(Stream, Encoding, Int32, Boolean)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

StreamWriter(String, Boolean, Encoding, Int32)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Opinia

Dodatkowe zasoby