StreamWriter.Write Método
Definición
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, utilizando la misma semántica que el método Format(String, Object, Object, Object). |
Write(String, Object, Object) |
Escribe una cadena con formato en la secuencia con la misma semántica que el método Format(String, Object, Object). |
Write(Char[], Int32, Int32) |
Escribe una subbarra de caracteres en la secuencia. |
Write(String, ReadOnlySpan<Object>) |
Escribe una cadena con formato en la secuencia, con la misma semántica que Format(String, ReadOnlySpan<Object>). |
Write(String, Object[]) |
Escribe una cadena con formato en la secuencia, utilizando la misma semántica que el método Format(String, Object[]). |
Write(ReadOnlySpan<Char>) |
Escribe un intervalo de caracteres en la secuencia. |
Write(String) |
Escribe una cadena en la secuencia. |
Write(Char[]) |
Escribe una matriz 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, utilizando la misma semántica que el método Format(String, Object). |
Write(String, Object, Object, Object)
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
Escribe una cadena con formato en la secuencia, utilizando la misma semántica que el método 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)
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
Escribe una cadena con formato en la secuencia con la misma semántica que el método Format(String, Object, Object).
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)
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
Escribe una subbarra 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 en el que se empiezan a leer los datos.
- count
- Int32
Número máximo de caracteres que se van a escribir.
Excepciones
buffer
es null
.
La longitud del búfer menos index
es menor que count
.
index
o count
es negativo.
Se produce un error de E/S.
AutoFlush es true o el búfer de StreamWriter está lleno y se cierra el sistema de escritura actual.
AutoFlush es true o el búfer de StreamWriter está lleno y el contenido del búfer no se puede escribir en la secuencia de tamaño fijo subyacente porque el StreamWriter está al final de la secuencia.
Ejemplos
En este ejemplo se escriben ocho caracteres de una matriz de 13 elementos en un archivo, comenzando 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 desde buffer
a partir de index
y continúan a través de 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 las tareas comunes de E/S, consulte Tareas de E/S comunes.
Consulte también
- de E/S de flujo y archivos
- Cómo: Leer texto de un de archivos
- Cómo: Escribir texto en un archivo
Se aplica a
Write(String, ReadOnlySpan<Object>)
Escribe una cadena con formato en la secuencia, con la misma semántica que Format(String, ReadOnlySpan<Object>).
public:
override void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public override void Write (string format, scoped ReadOnlySpan<object?> arg);
override this.Write : string * ReadOnlySpan<obj> -> unit
Public Overrides Sub Write (format As String, arg As ReadOnlySpan(Of Object))
Parámetros
- format
- String
Cadena de formato compuesto.
- arg
- ReadOnlySpan<Object>
Intervalo de objetos que contiene cero o más objetos para dar formato y escribir.
Se aplica a
Write(String, Object[])
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
Escribe una cadena con formato en la secuencia, utilizando la misma semántica que el método 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 para 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
Write(ReadOnlySpan<Char>)
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
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(String)
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
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 va a escribir en la secuencia. Si value
es NULL, no se escribe nada.
Excepciones
AutoFlush es true o el búfer de StreamWriter está lleno y se cierra el sistema de escritura actual.
AutoFlush es true o el búfer de StreamWriter está lleno y el contenido del búfer no se puede escribir en la secuencia de tamaño fijo subyacente porque el StreamWriter está al final de la secuencia.
Se produce un error de E/S.
Comentarios
Este método invalida TextWriter.Write.
El String especificado se escribe en la secuencia subyacente a menos que se alcance prematuramente el final de la secuencia.
Flush se invoca automáticamente si AutoFlush es true
. Si value
es null
, no se escribe ninguna entrada.
Para obtener una lista de las tareas comunes de E/S, consulte Tareas de E/S comunes.
Consulte también
- de E/S de flujo y archivos
- Cómo: Leer texto de un de archivos
- Cómo: Escribir texto en un archivo
Se aplica a
Write(Char[])
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
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
Se produce un error de E/S.
AutoFlush es true o el búfer de StreamWriter está lleno y se cierra el sistema de escritura actual.
AutoFlush es true o el búfer de StreamWriter está lleno y el contenido del búfer no se puede escribir en la secuencia de tamaño fijo subyacente porque el StreamWriter está al final de la secuencia.
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 true
, se invoca automáticamente Flush.
Este método puede proporcionar un rendimiento más rápido que Write
(char[],``int,``int
) porque tiene menos argumentos que comprobar.
Para obtener una lista de las tareas comunes de E/S, consulte Tareas de E/S comunes.
Consulte también
- de E/S de flujo y archivos
- Cómo: Leer texto de un de archivos
- Cómo: Escribir texto en un archivo
Se aplica a
Write(Char)
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
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
Se produce un error de E/S.
AutoFlush es true o el búfer de StreamWriter está lleno y se cierra el sistema de escritura actual.
AutoFlush es true o el búfer de StreamWriter está lleno y el contenido del búfer no se puede escribir en la secuencia de tamaño fijo subyacente porque el StreamWriter está al final de la secuencia.
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 true
, se invoca automáticamente Flush.
Para obtener una lista de las tareas comunes de E/S, consulte Tareas de E/S comunes.
Consulte también
- de E/S de flujo y archivos
- Cómo: Leer texto de un de archivos
- Cómo: Escribir texto en un archivo
Se aplica a
Write(String, Object)
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
Escribe una cadena con formato en la secuencia, utilizando la misma semántica que el método 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
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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de