StreamWriter.Write Método

Referencia

Definición

Espacio de nombres:: System.IO

Ensamblado:: System.Runtime.dll

Ensamblado:: netstandard.dll

Ensamblado:: System.Runtime.Extensions.dll

Ensamblado:: System.IO.dll

Ensamblado:: mscorlib.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Escribe datos en la secuencia.

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).
Write(String, Object, Object)	Escribe una cadena con formato en la secuencia con la misma semántica que el Format(String, Object, Object) método .
Write(Char[], Int32, Int32)	Escribe una submatriz de caracteres en la secuencia.
Write(String, Object[])	Escribe una cadena con formato en la secuencia, con la misma semántica que el método de Format(String, Object[]).
Write(Char[])	Escribe una matriz de caracteres en la secuencia.
Write(String)	Escribe una cadena en la secuencia.
Write(ReadOnlySpan<Char>)	Escribe un intervalo de caracteres en la secuencia.
Write(Char)	Escribe un carácter en la secuencia.
Write(String, Object)	Escribe una cadena con formato en la secuencia, con la misma semántica que el método de Format(String, Object).

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).

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.

arg0: Object

Primer objeto al que se va a dar formato y escribir.

arg1: Object

Segundo objeto al que se va a dar formato y escribir.

arg2: Object

Tercer objeto al que se va a dar formato y escribir.

Comentarios

Consulte Write(String, Object, Object, Object) para obtener una descripción de las funcionalidades de formato compuesto que se ofrecen.

Se aplica a

Write(String, Object, Object)

Escribe una cadena con formato en la secuencia con la misma semántica que el Format(String, Object, Object) método .

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.

arg0: Object

Primer objeto al que se va a dar formato y escribir.

arg1: Object

Segundo objeto al que se va a dar formato y escribir.

Comentarios

Consulte Write(String, Object, Object) para obtener una descripción de las funcionalidades de formato compuesto que se ofrecen.

Se aplica a

Write(Char[], Int32, Int32)

Escribe una submatriz de caracteres en la secuencia.

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.

index: Int32

Posición del carácter en el búfer donde comenzar la lectura de datos.

count: Int32

Número máximo de caracteres que se van a escribir.

Excepciones

ArgumentNullException

buffer es null.

ArgumentException

La longitud del búfer menos index es menor que count.

ArgumentOutOfRangeException

index o count es negativo.

IOException

Error de E/S.

ObjectDisposedException

AutoFlush es true o el búfer StreamWriter está lleno, y el sistema de escritura actual está cerrado.

NotSupportedException

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.

Ejemplos

En este ejemplo se escriben ocho caracteres de una matriz de 13 elementos en un archivo, empezando en el tercer elemento de la matriz.

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.

Los caracteres se leen buffer desde el principio y hasta + ( - index index count 1). Todos los caracteres se escriben en la secuencia subyacente a menos que se alcance prematuramente el final de la secuencia subyacente. Flush se invoca automáticamente si AutoFlush es true .

Para obtener una lista de tareas comunes de E/S, vea Tareas comunes de E/S.

Consulte también

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[]).

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.

arg: Object[]

Matriz de objetos que contiene cero o más objetos a los que se va a aplicar formato y escribir.

Comentarios

Consulte Write(String, Object[]) para obtener una descripción de las funcionalidades de formato compuesto que se ofrecen.

Se aplica a

Write(Char[])

Escribe una matriz de caracteres en la secuencia.

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. Si buffer es null, no se escribe nada.

Excepciones

IOException

Error de E/S.

ObjectDisposedException

AutoFlush es true o el búfer StreamWriter está lleno, y el sistema de escritura actual está cerrado.

NotSupportedException

Comentarios

Este método invalida TextWriter.Write.

Los caracteres especificados se escriben en la secuencia subyacente a menos que se alcance prematuramente el final de la secuencia. Si AutoFlush es , se invoca true Flush automáticamente.

Este método puede proporcionar un rendimiento más rápido que Write ( ) porque tiene menos char[],``int,``int argumentos que comprobar.

Para obtener una lista de tareas comunes de E/S, vea Tareas comunes de E/S.

Consulte también

Se aplica a

Write(String)

Escribe una cadena en la secuencia.

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. Si value es null, no se escribe nada.

Excepciones

ObjectDisposedException

AutoFlush es true o el búfer StreamWriter está lleno, y el sistema de escritura actual está cerrado.

NotSupportedException

IOException

Error de E/S.

Comentarios

Este método invalida TextWriter.Write.

El objeto especificado se escribe en la secuencia subyacente a menos que se alcance prematuramente el final String de la secuencia.

Flush se invoca automáticamente si AutoFlush es true . Si value es , no se escribe ninguna null entrada.

Para obtener una lista de tareas comunes de E/S, vea Tareas comunes de E/S.

Consulte también

Se aplica a

Write(ReadOnlySpan<Char>)

Escribe un intervalo de caracteres en la secuencia.

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.

Se aplica a

Write(Char)

Escribe un carácter en la secuencia.

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.

Excepciones

IOException

Error de E/S.

ObjectDisposedException

AutoFlush es true o el búfer StreamWriter está lleno, y el sistema de escritura actual está cerrado.

NotSupportedException

Comentarios

Este método invalida TextWriter.Write.

El carácter especificado se escribe en la secuencia subyacente a menos que se alcance prematuramente el final de la secuencia. Si AutoFlush es , se invoca true Flush automáticamente.

Para obtener una lista de tareas comunes de E/S, vea Tareas comunes de E/S.

Consulte también

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).

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.

arg0: Object

El objeto al que se va a dar formato y escribir.

Comentarios

Consulte Write(String, Object) para obtener una descripción de las funcionalidades de formato compuesto que se ofrecen.

Se aplica a

StreamWriter.Write Método

Definición

Sobrecargas

Write(String, Object, Object, Object)

Parámetros

Comentarios

Se aplica a

Write(String, Object, Object)

Parámetros

Comentarios

Se aplica a

Write(Char[], Int32, Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Write(String, Object[])

Parámetros

Comentarios

Se aplica a

Write(Char[])

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Write(String)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Write(ReadOnlySpan<Char>)

Parámetros

Se aplica a

Write(Char)

Parámetros

Excepciones

Comentarios

Consulte también

Se aplica a

Write(String, Object)

Parámetros

Comentarios

Se aplica a

Recursos adicionales