StreamWriter Costruttori
Definizione
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
| StreamWriter(Stream) |
Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica UTF-8 e le dimensioni del buffer predefinite. |
| StreamWriter(String) |
Inizializza una nuova istanza della classe StreamWriter per il file specificato usando la codifica e la dimensione del buffer predefinite. |
| StreamWriter(Stream, Encoding) |
Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica dei caratteri e le dimensioni del buffer specificate. |
| StreamWriter(String, Boolean) |
Inizializza una nuova istanza della classe StreamWriter per il file specificato usando la codifica e la dimensione del buffer predefinite. Se il file esiste, è possibile sovrascriverlo o aggiungervi informazioni. Se il file non esiste, il costruttore ne crea uno nuovo. |
| StreamWriter(String, FileStreamOptions) |
Inizializza una nuova istanza della StreamWriter classe per il file specificato, usando la codifica predefinita e configurata con l'oggetto specificato FileStreamOptions . |
| StreamWriter(Stream, Encoding, Int32) |
Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica caratteri e le dimensioni del buffer specificate. |
| StreamWriter(String, Boolean, Encoding) |
Inizializza una nuova istanza della classe StreamWriter per il file specificato usando la codifica specificata e le dimensioni del buffer predefinite. Se il file esiste, è possibile sovrascriverlo o aggiungervi informazioni. Se il file non esiste, il costruttore ne crea uno nuovo. |
| StreamWriter(String, Encoding, FileStreamOptions) |
Inizializza una nuova istanza della StreamWriter classe per il file specificato, usando la codifica specificata e configurata con l'oggetto specificato FileStreamOptions . |
| StreamWriter(Stream, Encoding, Int32, Boolean) |
Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica dei caratteri e le dimensioni del buffer specificate. Facoltativamente mantiene aperto il flusso. |
| StreamWriter(String, Boolean, Encoding, Int32) |
Inizializza una nuova istanza della classe StreamWriter per il file specificato nel percorso specificato, usando la codifica e le dimensioni del buffer specificate. Se il file esiste, è possibile sovrascriverlo o aggiungervi informazioni. Se il file non esiste, il costruttore ne crea uno nuovo. |
StreamWriter(Stream)
- Origine:
- StreamWriter.cs
- Origine:
- StreamWriter.cs
- Origine:
- StreamWriter.cs
Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica UTF-8 e le dimensioni del buffer predefinite.
public:
StreamWriter(System::IO::Stream ^ stream);public StreamWriter (System.IO.Stream stream);new System.IO.StreamWriter : System.IO.Stream -> System.IO.StreamWriterPublic Sub New (stream As Stream)Parametri
- stream
- Stream
Flusso in cui scrivere.
Eccezioni
stream non è scrivibile.
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 GetPreamble metodo 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 un'eccezione viene generata in byte non validi, usare un costruttore che accetta un oggetto di codifica come parametro, ad esempio StreamWriter. La BaseStream proprietà viene inizializzata usando il stream parametro . La posizione del flusso non viene reimpostata.
L'oggetto StreamWriter chiama Dispose() l'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 causare la generazione di un'eccezione.
Per un elenco di 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
Inizializza una nuova istanza della classe StreamWriter per il file specificato usando la codifica e la dimensione del buffer predefinite.
public:
StreamWriter(System::String ^ path);public StreamWriter (string path);new System.IO.StreamWriter : string -> System.IO.StreamWriterPublic Sub New (path As String)Parametri
- path
- String
Percorso completo del file in cui scrivere. path può essere un nome file.
Eccezioni
Accesso negato.
path è una stringa vuota ("").
-oppure-
path contiene il nome di una periferica di sistema (com1, com2 e così via).
path è null.
Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.
Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.
path include una sintassi non corretta o non valida per il nome file, il nome della directory o l'etichetta del volume.
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 GetPreamble metodo 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 una BOM e determinare se viene generata un'eccezione in byte non validi, usare un costruttore che accetta un oggetto di codifica come parametro, ad esempio StreamWriter(String, Boolean, Encoding).
Il path parametro può essere un nome 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 è necessario per essere un file archiviato su disco. Può essere parte di un sistema che supporta l'accesso tramite flussi.
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 causare la generazione di un'eccezione.
Per un elenco di 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
Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica dei caratteri e le dimensioni del buffer specificate.
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.StreamWriterPublic Sub New (stream As Stream, encoding As Encoding)Parametri
- stream
- Stream
Flusso in cui scrivere.
- encoding
- Encoding
Codifica dei caratteri da usare.
Eccezioni
stream o encoding è null.
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 proprietà usando il Encoding parametro di codifica e la BaseStream proprietà usando il parametro di flusso. La posizione del flusso non viene reimpostata. Per altre informazioni, vedere Encoding.
L'oggetto StreamWriter chiama Dispose() l'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 causare la generazione di un'eccezione.
Per un elenco di attività di I/O comuni, vedere Attività di I/O comuni.
Vedi anche
- Encoding
- I/O di file e di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
StreamWriter(String, Boolean)
- Origine:
- StreamWriter.cs
- Origine:
- StreamWriter.cs
- Origine:
- StreamWriter.cs
Inizializza una nuova istanza della classe StreamWriter per il file specificato usando la codifica e la dimensione del buffer predefinite. Se il file esiste, è possibile sovrascriverlo o aggiungervi informazioni. Se il file non esiste, il costruttore ne crea uno nuovo.
public:
StreamWriter(System::String ^ path, bool append);public StreamWriter (string path, bool append);new System.IO.StreamWriter : string * bool -> System.IO.StreamWriterPublic Sub New (path As String, append As Boolean)Parametri
- path
- String
Percorso completo del file in cui scrivere.
- append
- Boolean
true per aggiungere i dati al file; false per sovrascrivere il file. Se il file specificato non esiste, questo parametro non ha alcun effetto e viene creato un nuovo file dal costruttore.
Eccezioni
Accesso negato.
path è vuoto.
-oppure-
path contiene il nome di una periferica di sistema (com1, com2 e così via).
path è null.
Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.
path include una sintassi non corretta o non valida per il nome file, il nome della directory o l'etichetta del volume.
Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.
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 GetPreamble metodo 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 una BOM e determinare se viene generata un'eccezione in byte non validi, usare un costruttore che accetta un oggetto di codifica come parametro, ad esempio StreamWriter(String, Boolean, Encoding).
Il path parametro può essere un nome file, incluso un file in una condivisione UNC (Universal Naming Convention).
Il path parametro non è necessario per essere un file archiviato su disco. Può essere parte di un sistema che supporta l'accesso tramite flussi.
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 causare la generazione di un'eccezione.
Per un elenco di 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
Inizializza una nuova istanza della StreamWriter classe per il file specificato, usando 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.StreamWriterPublic Sub New (path As String, options As FileStreamOptions)Parametri
- path
- String
Percorso completo del file in cui scrivere.
- options
- FileStreamOptions
Oggetto che specifica le opzioni di configurazione per l'oggetto sottostante FileStream.
Eccezioni
options è null .
stream non è scrivibile.
Vedi anche
Si applica a
StreamWriter(Stream, Encoding, Int32)
- Origine:
- StreamWriter.cs
- Origine:
- StreamWriter.cs
- Origine:
- StreamWriter.cs
Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica caratteri 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);new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int -> System.IO.StreamWriterPublic Sub New (stream As Stream, encoding As Encoding, bufferSize As Integer)Parametri
- stream
- Stream
Flusso in cui scrivere.
- encoding
- Encoding
Codifica dei caratteri da usare.
- bufferSize
- Int32
Dimensioni del buffer, in byte.
Eccezioni
stream o encoding è null.
bufferSize è negativo.
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à usando il encoding parametro e la BaseStream proprietà usando il stream parametro . La posizione del flusso non viene reimpostata. Per altre informazioni, vedere Encoding.
L'oggetto StreamWriter chiama Dispose() l'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 causare la generazione di un'eccezione.
Per un elenco di attività di I/O comuni, vedere Attività di I/O comuni.
Vedi anche
- Encoding
- I/O di file e di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
StreamWriter(String, Boolean, Encoding)
- Origine:
- StreamWriter.cs
- Origine:
- StreamWriter.cs
- Origine:
- StreamWriter.cs
Inizializza una nuova istanza della classe StreamWriter per il file specificato usando la codifica specificata e le dimensioni del buffer predefinite. Se il file esiste, è possibile sovrascriverlo o aggiungervi informazioni. Se il file non esiste, il costruttore ne crea uno nuovo.
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.StreamWriterPublic Sub New (path As String, append As Boolean, encoding As Encoding)Parametri
- path
- String
Percorso completo del file in cui scrivere.
- append
- Boolean
true per aggiungere i dati al file; false per sovrascrivere il file. Se il file specificato non esiste, questo parametro non ha alcun effetto e viene creato un nuovo file dal costruttore.
- encoding
- Encoding
Codifica dei caratteri da usare.
Eccezioni
Accesso negato.
path è vuoto.
-oppure-
path contiene il nome di una periferica di sistema (com1, com2 e così via).
path è null.
Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.
path include una sintassi non corretta o non valida per il nome file, il nome della directory o l'etichetta del volume.
Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.
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à usando 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 è necessario essere un file archiviato su disco; può essere parte di un sistema che supporta l'accesso tramite flussi.
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 causare la generazione di un'eccezione.
Per un elenco di attività di I/O comuni, vedere Attività di I/O comuni.
Vedi anche
- Encoding
- I/O di file e di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
StreamWriter(String, Encoding, FileStreamOptions)
- Origine:
- StreamWriter.cs
- Origine:
- StreamWriter.cs
- Origine:
- StreamWriter.cs
Inizializza una nuova istanza della StreamWriter classe per il file specificato, usando 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);new System.IO.StreamWriter : string * System.Text.Encoding * System.IO.FileStreamOptions -> System.IO.StreamWriterPublic Sub New (path As String, encoding As Encoding, options As FileStreamOptions)Parametri
- path
- String
Percorso completo del file in cui scrivere.
- encoding
- Encoding
Codifica dei caratteri da usare.
- options
- FileStreamOptions
Oggetto che specifica le opzioni di configurazione per l'oggetto sottostante FileStream.
Eccezioni
options è null .
stream non è scrivibile.
Vedi anche
Si applica a
StreamWriter(Stream, Encoding, Int32, Boolean)
- Origine:
- StreamWriter.cs
- Origine:
- StreamWriter.cs
- Origine:
- StreamWriter.cs
Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica dei caratteri e le dimensioni del buffer specificate. Facoltativamente mantiene 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.StreamWriterPublic 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 usare.
- bufferSize
- Int32
Dimensioni del buffer, in byte.
- leaveOpen
- Boolean
true per mantenere il flusso aperto dopo avere eliminato l'oggetto StreamWriter; in caso contrario, false.
Eccezioni
stream o encoding è null.
bufferSize è negativo.
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 imposta il leaveOpen parametro su true, l'oggetto chiama Dispose() l'oggetto StreamWriter specificato Stream quando StreamWriter.Dispose viene chiamato.
Questo costruttore inizializza la Encoding proprietà usando il encoding parametro e inizializza la BaseStream proprietà usando il stream parametro . La posizione del flusso non viene reimpostata. Per altre informazioni, vedere la Encoding proprietà .
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 causare la generazione di un'eccezione.
Si applica a
StreamWriter(String, Boolean, Encoding, Int32)
- Origine:
- StreamWriter.cs
- Origine:
- StreamWriter.cs
- Origine:
- StreamWriter.cs
Inizializza una nuova istanza della classe StreamWriter per il file specificato nel percorso specificato, usando la codifica e le dimensioni del buffer specificate. Se il file esiste, è possibile sovrascriverlo o aggiungervi informazioni. Se il file non esiste, il costruttore ne crea uno nuovo.
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.StreamWriterPublic Sub New (path As String, append As Boolean, encoding As Encoding, bufferSize As Integer)Parametri
- path
- String
Percorso completo del file in cui scrivere.
- append
- Boolean
true per aggiungere i dati al file; false per sovrascrivere il file. Se il file specificato non esiste, questo parametro non ha alcun effetto e viene creato un nuovo file dal costruttore.
- encoding
- Encoding
Codifica dei caratteri da usare.
- bufferSize
- Int32
Dimensioni del buffer, in byte.
Eccezioni
path è una stringa vuota ("").
-oppure-
path contiene il nome di una periferica di sistema (com1, com2 e così via).
path o encoding è null.
bufferSize è negativo.
path include una sintassi non corretta o non valida per il nome file, il nome della directory o l'etichetta del volume.
Il chiamante non dispone dell'autorizzazione richiesta.
Accesso negato.
Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.
Il percorso specificato, il nome file 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à usando 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 è necessario essere un file archiviato su disco; può essere parte di un sistema che supporta l'accesso tramite flussi.
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 causare la generazione di un'eccezione.
Per un elenco di attività di I/O comuni, vedere Attività di I/O comuni.
Vedi anche
- Encoding
- I/O di file e di flussi
- Procedura: Leggere testo da un file
- Procedura: Scrivere un testo in un file
Si applica a
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per