StreamWriter.Write Método

Definición

Escribe datos en la secuencia.Writes data to the stream.

Sobrecargas

Write(String, Object, Object, Object)

Escribe una cadena con formato en la secuencia, con la misma semántica que el método de Format(String, Object, Object, Object).Writes a formatted string to the stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(String, Object, Object)

Escribe una cadena con formato en la secuencia, con la misma semántica que el método de Format(String, Object, Object).Writes a formatted string to the stream using the same semantics as the Format(String, Object, Object) method..

Write(Char[], Int32, Int32)

Escribe una submatriz de caracteres en la secuencia.Writes a subarray of characters to the stream.

Write(String, Object[])

Escribe una cadena con formato en la secuencia, con la misma semántica que el método de Format(String, Object[]).Writes a formatted string to the stream, using the same semantics as the Format(String, Object[]) method.

Write(ReadOnlySpan<Char>)

Escribe un intervalo de caracteres en la secuencia.Writes a character span to the stream.

Write(String)

Escribe una cadena en la secuencia.Writes a string to the stream.

Write(Char[])

Escribe una matriz de caracteres en la secuencia.Writes a character array to the stream.

Write(Char)

Escribe un carácter en la secuencia.Writes a character to the stream.

Write(String, Object)

Escribe una cadena con formato en la secuencia, con la misma semántica que el método de Format(String, Object).Writes a formatted string to the stream, using the same semantics as the Format(String, Object) method.

Write(String, Object, Object, Object)

Escribe una cadena con formato en la secuencia, con la misma semántica que el método de Format(String, Object, Object, Object).Writes a formatted string to the stream, using the same semantics as the Format(String, Object, Object, Object) method.

public:
 override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public override void Write (string format, object? arg0, object? arg1, object? arg2);
override this.Write : string * obj * obj * obj -> unit
Public Overrides Sub Write (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

Parámetros

format
String

Cadena de formato compuesto.A composite format string.

arg0
Object

Primer objeto al que se va a dar formato y escribir.The first object to format and write.

arg1
Object

Segundo objeto al que se va a dar formato y escribir.The second object to format and write.

arg2
Object

Tercer objeto al que se va a dar formato y escribir.The third object to format and write.

Comentarios

Vea Write(String, Object, Object, Object) para obtener una descripción de las capacidades de formato compuesto que se ofrecen.See Write(String, Object, Object, Object) for a description of the composite formatting capabilities offered.

Se aplica a

Write(String, Object, Object)

Escribe una cadena con formato en la secuencia, con la misma semántica que el método de Format(String, Object, Object).Writes a formatted string to the stream using the same semantics as the Format(String, Object, Object) method..

public:
 override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public override void Write (string format, object? arg0, object? arg1);
override this.Write : string * obj * obj -> unit
Public Overrides Sub Write (format As String, arg0 As Object, arg1 As Object)

Parámetros

format
String

Cadena de formato compuesto.A composite format string.

arg0
Object

Primer objeto al que se va a dar formato y escribir.The first object to format and write.

arg1
Object

Segundo objeto al que se va a dar formato y escribir.The second object to format and write.

Comentarios

Vea Write(String, Object, Object) para obtener una descripción de las capacidades de formato compuesto que se ofrecen.See Write(String, Object, Object) for a description of the composite formatting capabilities offered.

Se aplica a

Write(Char[], Int32, Int32)

Escribe una submatriz de caracteres en la secuencia.Writes a subarray of characters to the stream.

public:
 override void Write(cli::array <char> ^ buffer, int index, int count);
public override void Write (char[] buffer, int index, int count);
override this.Write : char[] * int * int -> unit
Public Overrides Sub Write (buffer As Char(), index As Integer, count As Integer)

Parámetros

buffer
Char[]

Matriz de caracteres que contiene los datos que se van a escribir.A character array that contains the data to write.

index
Int32

Posición del carácter en el búfer donde comenzar la lectura de datos.The character position in the buffer at which to start reading data.

count
Int32

Número máximo de caracteres que se van a escribir.The maximum number of characters to write.

Excepciones

buffer es null.buffer is null.

La longitud del búfer menos index es menor que count.The buffer length minus index is less than count.

index o count es negativo.index or count is negative.

Error de E/S.An I/O error occurs.

AutoFlush es true o el búfer StreamWriter está lleno, y el sistema de escritura actual está cerrado.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush es true o el búfer StreamWriter está lleno, y el contenido del búfer no puede escribirse en la secuencia de tamaño fijo subyacente porque StreamWriter se encuentra al final de la secuencia.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Ejemplos

En este ejemplo se escriben ocho caracteres de una matriz de 13 elementos en un archivo, comenzando por el tercer elemento de la matriz.This example writes eight characters from a 13-element array to a file, beginning at the third element of the array.

using namespace System;
using namespace System::IO;

int main()
{
   FileStream^ sb = gcnew FileStream( "MyFile.txt",FileMode::OpenOrCreate );
   array<Char>^b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
   StreamWriter^ sw = gcnew StreamWriter( sb );
   sw->Write( b, 3, 8 );
   sw->Close();
}
using System;
using System.IO;

public class SWBuff
{
    public static void Main(String[] args)
    {
        FileStream sb = new FileStream("MyFile.txt", FileMode.OpenOrCreate);
        char[] b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
        StreamWriter sw = new StreamWriter(sb);
        sw.Write(b, 3, 8);
        sw.Close();
    }
}
Imports System.IO

Public Class SWBuff

    Public Shared Sub Main()
        Dim sb As New FileStream("MyFile.txt", FileMode.OpenOrCreate)
        Dim b As Char() = {"a"c, "b"c, "c"c, "d"c, "e"c, "f"c, "g"c, _
           "h"c, "i"c, "j"c, "k"c, "l"c, "m"c}
        Dim sw As New StreamWriter(sb)
        sw.Write(b, 3, 8)
        sw.Close()
    End Sub
End Class

Comentarios

Este método invalida TextWriter.Write.This method overrides TextWriter.Write.

Los caracteres se leen desde buffer index y continúan hasta index + ( count -1).The characters are read from buffer beginning at index and continuing through index + (count - 1). Todos los caracteres se escriben en la secuencia subyacente a menos que el final de la secuencia subyacente se llegue prematuramente.All characters are written to the underlying stream unless the end of the underlying stream is reached prematurely. Flush se invoca automáticamente si AutoFlush es true .Flush is invoked automatically if AutoFlush is true.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Se aplica a

Write(String, Object[])

Escribe una cadena con formato en la secuencia, con la misma semántica que el método de Format(String, Object[]).Writes a formatted string to the stream, using the same semantics as the Format(String, Object[]) method.

public:
 override void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public override void Write (string format, params object?[] arg);
override this.Write : string * obj[] -> unit
Public Overrides Sub Write (format As String, ParamArray arg As Object())

Parámetros

format
String

Cadena de formato compuesto.A composite format string.

arg
Object[]

Matriz de objetos que contiene cero o más objetos a los que se va a aplicar formato y escribir.An object array that contains zero or more objects to format and write.

Comentarios

Vea Write(String, Object[]) para obtener una descripción de las capacidades de formato compuesto que se ofrecen.See Write(String, Object[]) for a description of the composite formatting capabilities offered.

Se aplica a

Write(ReadOnlySpan<Char>)

Escribe un intervalo de caracteres en la secuencia.Writes a character span to the stream.

public:
 override void Write(ReadOnlySpan<char> buffer);
public override void Write (ReadOnlySpan<char> buffer);
override this.Write : ReadOnlySpan<char> -> unit
Public Overrides Sub Write (buffer As ReadOnlySpan(Of Char))

Parámetros

buffer
ReadOnlySpan<Char>

Intervalo de caracteres que se va a escribir.The character span to write.

Se aplica a

Write(String)

Escribe una cadena en la secuencia.Writes a string to the stream.

public:
 override void Write(System::String ^ value);
public override void Write (string value);
public override void Write (string? value);
override this.Write : string -> unit
Public Overrides Sub Write (value As String)

Parámetros

value
String

Cadena que se debe escribir en la secuencia.The string to write to the stream. Si value es null, no se escribe nada.If value is null, nothing is written.

Excepciones

AutoFlush es true o el búfer StreamWriter está lleno, y el sistema de escritura actual está cerrado.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush es true o el búfer StreamWriter está lleno, y el contenido del búfer no puede escribirse en la secuencia de tamaño fijo subyacente porque StreamWriter se encuentra al final de la secuencia.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Error de E/S.An I/O error occurs.

Comentarios

Este método invalida TextWriter.Write.This method overrides TextWriter.Write.

El objeto especificado String se escribe en la secuencia subyacente a menos que el final de la secuencia se llegue prematuramente.The specified String is written to the underlying stream unless the end of the stream is reached prematurely.

Flush se invoca automáticamente si AutoFlush es true .Flush is invoked automatically if AutoFlush is true. Si value es null , no se escribe ninguna entrada.If value is null, no entries are written.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Se aplica a

Write(Char[])

Escribe una matriz de caracteres en la secuencia.Writes a character array to the stream.

public:
 override void Write(cli::array <char> ^ buffer);
public override void Write (char[] buffer);
public override void Write (char[]? buffer);
override this.Write : char[] -> unit
Public Overrides Sub Write (buffer As Char())

Parámetros

buffer
Char[]

Matriz de caracteres que contiene los datos que se van a escribir.A character array containing the data to write. Si buffer es null, no se escribe nada.If buffer is null, nothing is written.

Excepciones

Error de E/S.An I/O error occurs.

AutoFlush es true o el búfer StreamWriter está lleno, y el sistema de escritura actual está cerrado.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush es true o el búfer StreamWriter está lleno, y el contenido del búfer no puede escribirse en la secuencia de tamaño fijo subyacente porque StreamWriter se encuentra al final de la secuencia.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Comentarios

Este método invalida TextWriter.Write.This method overrides TextWriter.Write.

Los caracteres especificados se escriben en la secuencia subyacente a menos que el final de la secuencia se llegue prematuramente.The specified characters are written to the underlying stream unless the end of the stream is reached prematurely. Si AutoFlush es true , Flush se invoca automáticamente.If AutoFlush is true, Flush is invoked automatically.

Este método puede proporcionar un rendimiento más rápido que Write ( char[],``int,``int ) porque tiene menos argumentos para comprobar.This method might provide faster performance than Write (char[],``int,``int) because it has fewer arguments to check.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Se aplica a

Write(Char)

Escribe un carácter en la secuencia.Writes a character to the stream.

public:
 override void Write(char value);
public override void Write (char value);
override this.Write : char -> unit
Public Overrides Sub Write (value As Char)

Parámetros

value
Char

Carácter que se va a escribir en la secuencia.The character to write to the stream.

Excepciones

Error de E/S.An I/O error occurs.

AutoFlush es true o el búfer StreamWriter está lleno, y el sistema de escritura actual está cerrado.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush es true o el búfer StreamWriter está lleno, y el contenido del búfer no puede escribirse en la secuencia de tamaño fijo subyacente porque StreamWriter se encuentra al final de la secuencia.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Comentarios

Este método invalida TextWriter.Write.This method overrides TextWriter.Write.

El carácter especificado se escribe en la secuencia subyacente a menos que el final de la secuencia se llegue prematuramente.The specified character is written to the underlying stream unless the end of the stream is reached prematurely. Si AutoFlush es true , Flush se invoca automáticamente.If AutoFlush is true, Flush is invoked automatically.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Se aplica a

Write(String, Object)

Escribe una cadena con formato en la secuencia, con la misma semántica que el método de Format(String, Object).Writes a formatted string to the stream, using the same semantics as the Format(String, Object) method.

public:
 override void Write(System::String ^ format, System::Object ^ arg0);
public override void Write (string format, object? arg0);
override this.Write : string * obj -> unit
Public Overrides Sub Write (format As String, arg0 As Object)

Parámetros

format
String

Cadena de formato compuesto.A composite format string.

arg0
Object

El objeto al que se va a dar formato y escribir.The object to format and write.

Comentarios

Vea Write(String, Object) para obtener una descripción de las capacidades de formato compuesto que se ofrecen.See Write(String, Object) for a description of the composite formatting capabilities offered.

Se aplica a