StreamWriter Costruttori

Definizione

Spazio dei nomi:: System.IO

Assembly:: mscorlib.dll, System.IO.dll

Assembly:: netstandard.dll, System.Runtime.dll

Assembly:: System.IO.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Inizializza una nuova istanza della classe StreamWriter.

Overload

Nome	Descrizione
StreamWriter(Stream)	Inizializza una nuova istanza della StreamWriter classe per il flusso specificato utilizzando la codifica UTF-8 e le dimensioni predefinite del buffer.
StreamWriter(String)	Inizializza una nuova istanza della StreamWriter classe per il file specificato utilizzando la codifica predefinita e le dimensioni del buffer.
StreamWriter(Stream, Encoding)	Inizializza una nuova istanza della StreamWriter classe per il flusso specificato utilizzando la codifica specificata e le dimensioni predefinite del buffer.
StreamWriter(String, Boolean)	Inizializza una nuova istanza della StreamWriter classe per il file specificato utilizzando la codifica predefinita e le dimensioni del buffer. Se il file esiste, può essere sovrascritto o accodato. Se il file non esiste, questo costruttore crea un nuovo file.
StreamWriter(String, FileStreamOptions)	Inizializza una nuova istanza della StreamWriter classe per il file specificato, utilizzando la codifica predefinita e configurata con l'oggetto specificato FileStreamOptions .
StreamWriter(Stream, Encoding, Int32)	Inizializza una nuova istanza della StreamWriter classe per il flusso specificato utilizzando la codifica e le dimensioni del buffer specificate.
StreamWriter(String, Boolean, Encoding)	Inizializza una nuova istanza della StreamWriter classe per il file specificato utilizzando la codifica e le dimensioni predefinite del buffer specificate. Se il file esiste, può essere sovrascritto o accodato. Se il file non esiste, questo costruttore crea un nuovo file.
StreamWriter(String, Encoding, FileStreamOptions)	Inizializza una nuova istanza della StreamWriter classe per il file specificato, utilizzando la codifica specificata e configurata con l'oggetto specificato FileStreamOptions .
StreamWriter(Stream, Encoding, Int32, Boolean)	Inizializza una nuova istanza della StreamWriter classe per il flusso specificato utilizzando la codifica e le dimensioni del buffer specificate e, facoltativamente, lascia aperto il flusso.
StreamWriter(String, Boolean, Encoding, Int32)	Inizializza una nuova istanza della StreamWriter classe per il file specificato nel percorso specificato, utilizzando la codifica e le dimensioni del buffer specificate. Se il file esiste, può essere sovrascritto o accodato. Se il file non esiste, questo costruttore crea un nuovo file.

StreamWriter(Stream)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Inizializza una nuova istanza della StreamWriter classe per il flusso specificato utilizzando la codifica UTF-8 e le dimensioni predefinite del buffer.

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)

Parametri

stream: Stream

Flusso in cui scrivere.

Eccezioni

ArgumentException

stream non è scrivibile.

ArgumentNullException

stream è null.

Esempio

Nell'esempio di codice seguente viene illustrato questo costruttore.

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

Commenti

Questo costruttore crea un oggetto StreamWriter con codifica UTF-8 senza un Byte-Order Mark (BOM), quindi il metodo GetPreamble restituisce una matrice di byte vuota. La codifica UTF-8 predefinita per questo costruttore genera un'eccezione in byte non validi. Questo comportamento è diverso dal comportamento fornito dall'oggetto di codifica nella Encoding.UTF8 proprietà . Per specificare se viene generata un'eccezione in byte non validi, utilizzare un costruttore che accetta un oggetto di codifica come parametro, ad esempio StreamWriter. La BaseStream proprietà viene inizializzata utilizzando il stream parametro . La posizione del flusso non viene reimpostata.

L'oggetto StreamWriter chiama Dispose() sull'oggetto specificato Stream quando StreamWriter.Dispose viene chiamato .

Attenzione

Quando si compila un set di caratteri con un'impostazione culturale specifica e si recuperano gli stessi caratteri con un'impostazione culturale diversa, i caratteri potrebbero non essere interpretabili e potrebbero generare un'eccezione.

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

StreamWriter(String)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Inizializza una nuova istanza della StreamWriter classe per il file specificato utilizzando la codifica predefinita e le dimensioni del buffer.

public:
 StreamWriter(System::String ^ path);

public StreamWriter(string path);

new System.IO.StreamWriter : string -> System.IO.StreamWriter

Public Sub New (path As String)

Parametri

path: String

Percorso del file completo in cui scrivere. path può essere un nome di file.

Eccezioni

UnauthorizedAccessException

Accesso negato.

ArgumentException

path è una stringa vuota ("").

oppure

path contiene il nome di un dispositivo di sistema (com1, com2 e così via).

ArgumentNullException

path è null.

DirectoryNotFoundException

Il percorso specificato non è valido( ad esempio, si trova in un'unità non mappata).

PathTooLongException

Il percorso, il nome file specificato o entrambi superano la lunghezza massima definita dal sistema.

IOException

path include una sintassi non corretta o non valida per il nome file, il nome della directory o la sintassi dell'etichetta del volume.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

Esempio

Nell'esempio di codice seguente viene illustrato questo costruttore.

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

Commenti

Questo costruttore crea un oggetto StreamWriter con codifica UTF-8 senza un Byte-Order Mark (BOM), quindi il metodo GetPreamble restituisce una matrice di byte vuota. La codifica UTF-8 predefinita per questo costruttore genera un'eccezione in byte non validi. Questo comportamento è diverso dal comportamento fornito dall'oggetto di codifica nella Encoding.UTF8 proprietà . Per specificare un BOM e determinare se viene generata un'eccezione in byte non validi, utilizzare un costruttore che accetta un oggetto di codifica come parametro, ad esempio StreamWriter(String, Boolean, Encoding).

Il path parametro può essere un nome di file, incluso un file in una condivisione UNC (Universal Naming Convention). Se il file esiste, viene sovrascritto; in caso contrario, viene creato un nuovo file.

Il path parametro non deve essere un file archiviato su disco. Può essere parte di un sistema che supporta l'accesso tramite flussi.

Attenzione

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

StreamWriter(Stream, Encoding)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Inizializza una nuova istanza della StreamWriter classe per il flusso specificato utilizzando la codifica specificata e le dimensioni predefinite del buffer.

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)

Parametri

stream: Stream

Flusso in cui scrivere.

encoding: Encoding

Codifica dei caratteri da utilizzare.

Eccezioni

ArgumentNullException

stream o encoding è null.

ArgumentException

stream non è scrivibile.

Esempio

Nell'esempio seguente viene illustrato questo costruttore.

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

Commenti

Questo costruttore inizializza la Encoding proprietà usando il parametro di codifica e la BaseStream proprietà usando il parametro stream. La posizione del flusso non viene reimpostata. Per altre informazioni, vedere Encoding.

L'oggetto StreamWriter chiama Dispose() sull'oggetto specificato Stream quando StreamWriter.Dispose viene chiamato .

Attenzione

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

StreamWriter(String, Boolean)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Inizializza una nuova istanza della StreamWriter classe per il file specificato utilizzando la codifica predefinita e le dimensioni del buffer. Se il file esiste, può essere sovrascritto o accodato. Se il file non esiste, questo costruttore crea un nuovo file.

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)

Parametri

path: String

Percorso del file completo in cui scrivere.

append: Boolean

true per accodare i dati al file; false per sovrascrivere il file. Se il file specificato non esiste, questo parametro non ha alcun effetto e il costruttore crea un nuovo file.

Eccezioni

UnauthorizedAccessException

Accesso negato.

ArgumentException

path è vuoto.

oppure

path contiene il nome di un dispositivo di sistema (com1, com2 e così via).

ArgumentNullException

path è null.

DirectoryNotFoundException

Il percorso specificato non è valido( ad esempio, si trova in un'unità non mappata).

IOException

path include una sintassi non corretta o non valida per il nome file, il nome della directory o la sintassi dell'etichetta del volume.

PathTooLongException

Il percorso, il nome file specificato o entrambi superano la lunghezza massima definita dal sistema.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

Esempio

Nell'esempio di codice seguente viene illustrato questo costruttore.

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

Commenti

Questo costruttore crea un oggetto StreamWriter con codifica UTF-8 senza un Byte-Order Mark (BOM), quindi il metodo GetPreamble restituisce una matrice di byte vuota. La codifica UTF-8 predefinita per questo costruttore genera un'eccezione in byte non validi. Questo comportamento è diverso dal comportamento fornito dall'oggetto di codifica nella Encoding.UTF8 proprietà . Per specificare un BOM e determinare se viene generata un'eccezione in byte non validi, utilizzare un costruttore che accetta un oggetto di codifica come parametro, ad esempio StreamWriter(String, Boolean, Encoding).

Il path parametro può essere un nome di file, incluso un file in una condivisione UNC (Universal Naming Convention).

Il path parametro non deve essere un file archiviato su disco. Può essere parte di un sistema che supporta l'accesso tramite flussi.

Attenzione

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

StreamWriter(String, FileStreamOptions)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Inizializza una nuova istanza della StreamWriter classe per il file specificato, utilizzando la codifica predefinita e configurata con l'oggetto specificato FileStreamOptions .

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)

Parametri

path: String

Percorso del file completo in cui scrivere.

options: FileStreamOptions

Oggetto che specifica le opzioni di configurazione per l'oggetto sottostante FileStream.

Eccezioni

ArgumentNullException

options è null .

ArgumentException

path non è scrivibile.

Vedi anche

Si applica a

StreamWriter(Stream, Encoding, Int32)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Inizializza una nuova istanza della StreamWriter classe per il flusso specificato utilizzando la codifica e le dimensioni del buffer specificate.

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)

Parametri

stream: Stream

Flusso in cui scrivere.

encoding: Encoding

Codifica dei caratteri da utilizzare.

bufferSize: Int32

Dimensioni del buffer, in caratteri.

Eccezioni

ArgumentNullException

stream o encoding è null.

ArgumentOutOfRangeException

bufferSize è minore o uguale a zero, ad eccezione di -1, che può indicare le dimensioni predefinite del buffer.

ArgumentException

stream non è scrivibile.

Esempio

Nell'esempio seguente viene illustrato questo costruttore.

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

Commenti

Questo costruttore inizializza la Encoding proprietà utilizzando il encoding parametro e la BaseStream proprietà utilizzando il stream parametro . La posizione del flusso non viene reimpostata. Per altre informazioni, vedere Encoding.

L'oggetto StreamWriter chiama Dispose() sull'oggetto specificato Stream quando StreamWriter.Dispose viene chiamato .

Attenzione

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

StreamWriter(String, Boolean, Encoding)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Inizializza una nuova istanza della StreamWriter classe per il file specificato utilizzando la codifica e le dimensioni predefinite del buffer specificate. Se il file esiste, può essere sovrascritto o accodato. Se il file non esiste, questo costruttore crea un nuovo file.

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)

Parametri

path: String

Percorso del file completo in cui scrivere.

append: Boolean

true per accodare i dati al file; false per sovrascrivere il file. Se il file specificato non esiste, questo parametro non ha alcun effetto e il costruttore crea un nuovo file.

encoding: Encoding

Codifica dei caratteri da utilizzare.

Eccezioni

UnauthorizedAccessException

Accesso negato.

ArgumentException

path è vuoto.

oppure

path contiene il nome di un dispositivo di sistema (com1, com2 e così via).

ArgumentNullException

path è null.

DirectoryNotFoundException

Il percorso specificato non è valido( ad esempio, si trova in un'unità non mappata).

IOException

path include una sintassi non corretta o non valida per il nome file, il nome della directory o la sintassi dell'etichetta del volume.

PathTooLongException

Il percorso, il nome file specificato o entrambi superano la lunghezza massima definita dal sistema.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

Esempio

Nell'esempio seguente viene illustrato questo costruttore.

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

Commenti

Questo costruttore inizializza la Encoding proprietà utilizzando il parametro di codifica. Per altre informazioni, vedere Encoding.

path può essere un nome di file, incluso un file in una condivisione UNC (Universal Naming Convention).

path non deve essere un file archiviato su disco; può essere parte di un sistema che supporta l'accesso tramite flussi.

Attenzione

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

StreamWriter(String, Encoding, FileStreamOptions)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Inizializza una nuova istanza della StreamWriter classe per il file specificato, utilizzando la codifica specificata e configurata con l'oggetto specificato FileStreamOptions .

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)

Parametri

path: String

Percorso del file completo in cui scrivere.

encoding: Encoding

Codifica dei caratteri da utilizzare.

options: FileStreamOptions

Oggetto che specifica le opzioni di configurazione per l'oggetto sottostante FileStream.

Eccezioni

ArgumentNullException

options è null .

ArgumentException

path non è scrivibile.

Vedi anche

Si applica a

StreamWriter(Stream, Encoding, Int32, Boolean)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Inizializza una nuova istanza della StreamWriter classe per il flusso specificato utilizzando la codifica e le dimensioni del buffer specificate e, facoltativamente, lascia aperto il flusso.

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)

Parametri

stream: Stream

Flusso in cui scrivere.

encoding: Encoding

Codifica dei caratteri da utilizzare.

bufferSize: Int32

Dimensioni del buffer, in caratteri.

leaveOpen: Boolean

true per lasciare aperto il flusso dopo l'eliminazione dell'oggetto StreamWriter ; in caso contrario, false.

Eccezioni

ArgumentNullException

stream o encoding è null.

ArgumentOutOfRangeException

bufferSize è minore o uguale a zero, ad eccezione di -1, che può indicare le dimensioni predefinite del buffer.

ArgumentException

stream non è scrivibile.

Esempio

Nell'esempio seguente viene illustrato questo costruttore.

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

Commenti

A meno che non si imposti il leaveOpen parametro su true, l'oggetto StreamWriter chiama Dispose() sull'oggetto fornito Stream quando StreamWriter.Dispose viene chiamato.

Questo costruttore inizializza la Encoding proprietà utilizzando il encoding parametro e inizializza la BaseStream proprietà utilizzando il stream parametro . La posizione del flusso non viene reimpostata. Per altre informazioni, vedere la Encoding proprietà .

Attenzione

Si applica a

StreamWriter(String, Boolean, Encoding, Int32)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Inizializza una nuova istanza della StreamWriter classe per il file specificato nel percorso specificato, utilizzando la codifica e le dimensioni del buffer specificate. Se il file esiste, può essere sovrascritto o accodato. Se il file non esiste, questo costruttore crea un nuovo file.

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)

Parametri

path: String

Percorso del file completo in cui scrivere.

append: Boolean

true per accodare i dati al file; false per sovrascrivere il file. Se il file specificato non esiste, questo parametro non ha alcun effetto e il costruttore crea un nuovo file.

encoding: Encoding

Codifica dei caratteri da utilizzare.

bufferSize: Int32

Dimensioni del buffer, in caratteri.

Eccezioni

ArgumentException

path è una stringa vuota ("").

oppure

path contiene il nome di un dispositivo di sistema (com1, com2 e così via).

ArgumentNullException

path o encoding è null.

ArgumentOutOfRangeException

bufferSize è minore o uguale a zero, ad eccezione di -1, che può indicare le dimensioni predefinite del buffer.

IOException

path include una sintassi non corretta o non valida per il nome file, il nome della directory o la sintassi dell'etichetta del volume.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

UnauthorizedAccessException

Accesso negato.

DirectoryNotFoundException

Il percorso specificato non è valido( ad esempio, si trova in un'unità non mappata).

PathTooLongException

Il percorso, il nome file specificato o entrambi superano la lunghezza massima definita dal sistema.

Esempio

Nell'esempio seguente viene illustrato questo costruttore.

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

Commenti

Questo costruttore inizializza la Encoding proprietà utilizzando il parametro di codifica. Per altre informazioni, vedere Encoding.

path può essere un nome di file, incluso un file in una condivisione UNC (Universal Naming Convention).

path non deve essere un file archiviato su disco; può essere parte di un sistema che supporta l'accesso tramite flussi.

Attenzione

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?

Condividi tramite

StreamWriter Costruttori

Definizione

Overload

StreamWriter(Stream)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

StreamWriter(String)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

StreamWriter(Stream, Encoding)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

StreamWriter(String, Boolean)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

StreamWriter(String, FileStreamOptions)

Parametri

Eccezioni

Vedi anche

Si applica a

StreamWriter(Stream, Encoding, Int32)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

StreamWriter(String, Boolean, Encoding)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

StreamWriter(String, Encoding, FileStreamOptions)

Parametri

Eccezioni

Vedi anche

Si applica a

StreamWriter(Stream, Encoding, Int32, Boolean)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

StreamWriter(String, Boolean, Encoding, Int32)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Commenti e suggerimenti