Udostępnij za pośrednictwem


StreamWriter Konstruktory

Definicja

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

stream nie jest zapisywalny.

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

Odmowa dostępu.

path jest pustym ciągiem ("").

-lub-

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

path to null.

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

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

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

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

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(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

stream lub encoding to null.

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

Odmowa dostępu.

path jest pusty.

-lub-

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

path to null.

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

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

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

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

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, 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

options to null .

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

stream lub encoding to null.

bufferSize jest ujemna.

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

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, 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

Odmowa dostępu.

path jest pusty.

-lub-

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

path to null.

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

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

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

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

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, 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

options to null .

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

stream lub encoding to null.

bufferSize jest ujemna.

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

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.

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

path jest pustym ciągiem ("").

-lub-

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

path lub encoding to null.

bufferSize jest ujemna.

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

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

Odmowa dostępu.

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

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

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