TextWriter.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 una secuencia de texto.
Sobrecargas
Write(String, Object, Object, Object) |
Escribe una cadena con formato en la secuencia de texto con la misma semántica que el método Format(String, Object, Object, Object). |
Write(Char[], Int32, Int32) |
Escribe una submatriz de caracteres en la secuencia de texto. |
Write(String, Object[]) |
Escribe una cadena con formato en la secuencia de texto con la misma semántica que el método Format(String, Object[]). |
Write(String, Object) |
Escribe una cadena con formato en la secuencia de texto con la misma semántica que el método Format(String, Object). |
Write(UInt64) |
Escribe la representación de texto de un entero sin signo de 8 bytes en la secuencia de texto. |
Write(UInt32) |
Escribe la representación de texto de un entero sin signo de 4 bytes en la secuencia de texto. |
Write(StringBuilder) |
Escribe un generador de cadenas en la secuencia de texto. |
Write(String) |
Escribe una cadena en la secuencia de texto. |
Write(Single) |
Escribe la representación de texto de un valor de punto flotante de 4 bytes en la secuencia de texto. |
Write(String, Object, Object) |
Escribe una cadena con formato en la secuencia de texto con la misma semántica que el método Format(String, Object, Object). |
Write(Object) |
Escribe la representación de texto de un objeto en la secuencia de texto mediante una llamada al método |
Write(Int64) |
Escribe la representación de texto de un entero con signo de 8 bytes en la secuencia de texto. |
Write(Int32) |
Escribe la representación de texto de un entero con signo de 4 bytes en la secuencia de texto. |
Write(Double) |
Escribe la representación de texto de un punto flotante de 8 bytes en la secuencia de texto. |
Write(Decimal) |
Escribe la representación de texto de un valor decimal en la secuencia de texto. |
Write(Char[]) |
Escribe una matriz de caracteres en la secuencia de texto. |
Write(Char) |
Escribe un carácter en la secuencia de texto. |
Write(Boolean) |
Escribe la representación de texto de un valor |
Write(ReadOnlySpan<Char>) |
Escribe un intervalo de caracteres en la secuencia de texto. |
Write(String, Object, Object, Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe una cadena con formato en la secuencia de texto con la misma semántica que el método Format(String, Object, Object, Object).
public:
virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public virtual void Write (string format, object arg0, object arg1, object arg2);
public virtual void Write (string format, object? arg0, object? arg1, object? arg2);
abstract member Write : string * obj * obj * obj -> unit
override this.Write : string * obj * obj * obj -> unit
Public Overridable 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.
Excepciones
format
es null
.
La clase TextWriter está cerrada.
Error de E/S.
format
no es una cadena de formato compuesta.
o bien
El índice de un elemento de formato es menor que 0 (cero), o mayor o igual que el número de objetos a los que se va a dar formato (que, para esta sobrecarga del método, es tres).
Comentarios
Este método usa formato compuesto para convertir el valor de un objeto en su representación de cadena e insertar esa representación en una cadena. .NET proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los temas de formato siguientes:
Para obtener más información sobre la característica de formato compuesto, consulte Formato compuesto.
Para obtener más información sobre los especificadores de formato numérico, vea Cadenas de formato numérico estándar y Cadenas de formato numérico personalizado.
Para obtener más información sobre los especificadores de formato de fecha y hora, vea Cadenas de formato de fecha y hora estándar y cadenas de formato de fecha y hora personalizados.
Para obtener más información sobre los especificadores de formato de enumeración, vea Cadenas de formato de enumeración.
Para obtener más información sobre el formato, vea Tipos de formato.
El format
parámetro consta de cero o más ejecuciones de texto entremezcladas con cero o más marcadores de posición indexados, denominados elementos de formato, que corresponden a un objeto de la lista de parámetros de este método. El proceso de formato reemplaza cada elemento de formato por la representación de cadena del valor del objeto correspondiente.
La sintaxis de un elemento de formato es la siguiente:
{index[,length][:formatString]}
Los elementos entre corchetes son opcionales. En esta tabla se describe cada elemento. Para obtener más información sobre la característica de formato compuesto, incluida la sintaxis de un elemento de formato, vea Formato compuesto.
Elemento | Descripción |
---|---|
índice | Posición de base cero en la lista de parámetros del objeto al que se va a dar formato. Si el objeto especificado por index es null , el elemento de formato se reemplaza por String.Empty. Dado que esta sobrecarga tiene tres objetos en su lista de parámetros, el valor del índice siempre debe ser 0, 1 o 2. Si no hay ningún parámetro en la posición del índice , se produce una FormatException excepción . |
,length | Número mínimo de caracteres en la representación de cadena del parámetro. Si es positivo, el parámetro está alineado a la derecha; si es negativo, está alineado a la izquierda. |
:formatString | Cadena de formato estándar o personalizada compatible con el objeto al que se va a dar formato. Los valores posibles para formatString son los mismos que los valores admitidos por el método del ToString(string format) objeto. Si no se especifica formatString y el objeto al que se va a dar formato implementa la IFormattable interfaz, null se pasa como el valor del format parámetro que se usa como cadena de IFormattable.ToString formato. |
Se requieren los caracteres de llave inicial y final, "{" y "}". Para especificar un carácter de llave literal único en format
, especifique dos caracteres de llave inicial o final; es decir, "{{" o "}}".
Este método no busca en la cadena especificada caracteres de nueva línea individuales (0x000a hexadecimal) y los TextWriter.NewLinereemplaza por .
Si no se hace referencia a un objeto especificado en la cadena de formato, se omite.
Para obtener una lista de las tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- StreamWriter
- StringWriter
- IFormatProvider
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(Char[], Int32, Int32)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe una submatriz de caracteres en la secuencia de texto.
public:
virtual void Write(cli::array <char> ^ buffer, int index, int count);
public virtual void Write (char[] buffer, int index, int count);
abstract member Write : char[] * int * int -> unit
override this.Write : char[] * int * int -> unit
Public Overridable Sub Write (buffer As Char(), index As Integer, count As Integer)
Parámetros
- buffer
- Char[]
Matriz de caracteres de la que se escriben los datos.
- index
- Int32
Posición del carácter en el búfer donde comenzar la recuperación de datos.
- count
- Int32
Número de caracteres que se van a escribir.
Excepciones
La longitud del búfer menos index
es menor que count
.
El parámetro buffer
es null
.
index
o count
es negativo.
La clase TextWriter está cerrada.
Error de E/S.
Comentarios
Este método escribirá count
caracteres de datos en esta TextWriter
desde la buffer
matriz de caracteres a partir de la posición index
.
Esta sobrecarga es equivalente a la Write(Char[]) sobrecarga de cada carácter entre buffer
index
y (index
+ count
).
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- Write(Char[], Int32, Int32)
- Write(Char[], Int32, Int32)
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(String, Object[])
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe una cadena con formato en la secuencia de texto con la misma semántica que el método Format(String, Object[]).
public:
virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void Write (string format, params object[] arg);
public virtual void Write (string format, params object?[] arg);
abstract member Write : string * obj[] -> unit
override this.Write : string * obj[] -> unit
Public Overridable 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.
Excepciones
format
o arg
es null
.
La clase TextWriter está cerrada.
Error de E/S.
format
no es una cadena de formato compuesta.
o bien
El índice de un elemento de formato es menor que 0 (cero), o mayor o igual que la longitud de la matriz arg
.
Comentarios
Este método usa formato compuesto para convertir el valor de un objeto en su representación de cadena e insertar esa representación en una cadena. .NET proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los temas de formato siguientes:
Para obtener más información sobre la característica de formato compuesto, consulte Formato compuesto.
Para obtener más información sobre los especificadores de formato numérico, vea Cadenas de formato numérico estándar y Cadenas de formato numérico personalizado.
Para obtener más información sobre los especificadores de formato de fecha y hora, vea Cadenas de formato de fecha y hora estándar y cadenas de formato de fecha y hora personalizados.
Para obtener más información sobre los especificadores de formato de enumeración, vea Cadenas de formato de enumeración.
Para obtener más información sobre el formato, vea Tipos de formato.
El format
parámetro consta de cero o más ejecuciones de texto entremezcladas con cero o más marcadores de posición indexados, denominados elementos de formato, que corresponden a un objeto de la lista de parámetros de este método. El proceso de formato reemplaza cada elemento de formato por la representación de cadena del valor del objeto correspondiente.
La sintaxis de un elemento de formato es la siguiente:
{index[,length][:formatString]}
Los elementos entre corchetes son opcionales. En esta tabla se describe cada elemento. Para obtener más información sobre la característica de formato compuesto, incluida la sintaxis de un elemento de formato, vea Formato compuesto.
Elemento | Descripción |
---|---|
índice | Posición de base cero en la lista de parámetros del objeto al que se va a dar formato. Si el objeto especificado por índice es null , el elemento de formato se reemplaza por String.Empty. Dado que esta sobrecarga tiene una matriz en su lista de parámetros, el valor de índice siempre debe ser menor que la longitud de la matriz. Si no hay ningún parámetro en la posición de índice , se produce una FormatException excepción . |
,length | Número mínimo de caracteres en la representación de cadena del parámetro. Si es positivo, el parámetro está alineado a la derecha; si es negativo, está alineado a la izquierda. |
:formatString | Cadena de formato estándar o personalizado compatible con el objeto al que se va a dar formato. Los valores posibles para formatString son los mismos que los valores admitidos por el método del ToString(string format) objeto. Si no se especifica formatString y el objeto al que se va a dar formato implementa la IFormattable interfaz, null se pasa como el valor del format parámetro que se usa como cadena de IFormattable.ToString formato. |
Se requieren los caracteres de llave inicial y final, "{" y "}". Para especificar un carácter de llave literal único en format
, especifique dos caracteres de llave inicial o final; es decir, "{{" o "}}".
Este método no busca en la cadena especificada caracteres de nueva línea individuales (0x000a hexadecimal) y los reemplaza por TextWriter.NewLine.
Si no se hace referencia a un objeto especificado en la cadena de formato, se omite.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- StreamWriter
- StringWriter
- IFormatProvider
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(String, Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe una cadena con formato en la secuencia de texto con la misma semántica que el método Format(String, Object).
public:
virtual void Write(System::String ^ format, System::Object ^ arg0);
public virtual void Write (string format, object arg0);
public virtual void Write (string format, object? arg0);
abstract member Write : string * obj -> unit
override this.Write : string * obj -> unit
Public Overridable 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.
Excepciones
format
es null
.
La clase TextWriter está cerrada.
Error de E/S.
format
no es una cadena de formato compuesta.
o bien
El índice de un elemento de formato es menor que 0 (cero), o mayor o igual que el número de objetos a los que se va a dar formato (que, para esta sobrecarga del método, es uno).
Comentarios
Este método usa formato compuesto para convertir el valor de un objeto en su representación de cadena e insertar esa representación en una cadena. .NET proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los temas de formato siguientes:
Para obtener más información sobre la característica de formato compuesto, consulte Formato compuesto.
Para obtener más información sobre los especificadores de formato numérico, vea Cadenas de formato numérico estándar y Cadenas de formato numérico personalizado.
Para obtener más información sobre los especificadores de formato de fecha y hora, vea Cadenas de formato de fecha y hora estándar y cadenas de formato de fecha y hora personalizados.
Para obtener más información sobre los especificadores de formato de enumeración, vea Cadenas de formato de enumeración.
Para obtener más información sobre el formato, vea Tipos de formato.
El format
parámetro consta de cero o más ejecuciones de texto entremezcladas con cero o más marcadores de posición indexados, denominados elementos de formato, que corresponden a un objeto de la lista de parámetros de este método. El proceso de formato reemplaza cada elemento de formato por la representación de cadena del valor del objeto correspondiente.
La sintaxis de un elemento de formato es la siguiente:
{index[,length][:formatString]}
Los elementos entre corchetes son opcionales. En esta tabla se describe cada elemento. Para obtener más información sobre la característica de formato compuesto, incluida la sintaxis de un elemento de formato, vea Formato compuesto.
Elemento | Descripción |
---|---|
índice | Posición de base cero en la lista de parámetros del objeto al que se va a dar formato. Si el objeto especificado por índice es null , el elemento de formato se reemplaza por String.Empty. Dado que esta sobrecarga solo tiene un único objeto en su lista de parámetros, el valor del índice siempre debe ser 0. Si no hay ningún parámetro en la posición de índice , se produce una FormatException excepción . |
,length | Número mínimo de caracteres en la representación de cadena del parámetro. Si es positivo, el parámetro está alineado a la derecha; si es negativo, está alineado a la izquierda. |
:formatString | Cadena de formato estándar o personalizado compatible con el objeto al que se va a dar formato. Los valores posibles para formatString son los mismos que los valores admitidos por el método del ToString(string format) objeto. Si no se especifica formatString y el objeto al que se va a dar formato implementa la IFormattable interfaz, null se pasa como el valor del format parámetro que se usa como cadena de IFormattable.ToString formato. |
Se requieren los caracteres de llave inicial y final, "{" y "}". Para especificar un carácter de llave literal único en format
, especifique dos caracteres de llave inicial o final; es decir, "{{" o "}}".
Este método no busca en la cadena especificada caracteres de nueva línea individuales (0x000a hexadecimal) y los reemplaza por TextWriter.NewLine.
Si no se hace referencia a un objeto especificado en la cadena de formato, se omite.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- StreamWriter
- StringWriter
- IFormatProvider
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(UInt64)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Importante
Esta API no es conforme a CLS.
Escribe la representación de texto de un entero sin signo de 8 bytes en la secuencia de texto.
public:
virtual void Write(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void Write (ulong value);
[<System.CLSCompliant(false)>]
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit
Public Overridable Sub Write (value As ULong)
Parámetros
- value
- UInt64
Entero de 8 bytes sin signo que se va a escribir.
- Atributos
Excepciones
La clase TextWriter está cerrada.
Error de E/S.
Comentarios
La representación de texto del valor especificado se genera mediante una llamada al UInt64.ToString método . La TextWriter.FormatProvider propiedad, si no null
es , especifica el formato específico de la referencia cultural.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- StreamWriter
- StringWriter
- IFormatProvider
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(UInt32)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Importante
Esta API no es conforme a CLS.
Escribe la representación de texto de un entero sin signo de 4 bytes en la secuencia de texto.
public:
virtual void Write(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void Write (uint value);
[<System.CLSCompliant(false)>]
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit
Public Overridable Sub Write (value As UInteger)
Parámetros
- value
- UInt32
Entero de 4 bytes sin signo que se va a escribir.
- Atributos
Excepciones
La clase TextWriter está cerrada.
Error de E/S.
Comentarios
La representación de texto del valor especificado se genera mediante una llamada al UInt32.ToString método . La TextWriter.FormatProvider propiedad, si no null
es , especifica el formato específico de la referencia cultural.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- StreamWriter
- StringWriter
- IFormatProvider
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(StringBuilder)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe un generador de cadenas en la secuencia de texto.
public:
virtual void Write(System::Text::StringBuilder ^ value);
public virtual void Write (System.Text.StringBuilder? value);
abstract member Write : System.Text.StringBuilder -> unit
override this.Write : System.Text.StringBuilder -> unit
Public Overridable Sub Write (value As StringBuilder)
Parámetros
- value
- StringBuilder
Cadena, como generador de cadenas, que se va a escribir en la secuencia de texto.
Comentarios
Este método es equivalente a Write(stringBuilder.ToString())
, pero usa el StringBuilder.GetChunks método para evitar crear la cadena intermedia.
Se aplica a
Write(String)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe una cadena en la secuencia de texto.
public:
virtual void Write(System::String ^ value);
public virtual void Write (string value);
public virtual void Write (string? value);
abstract member Write : string -> unit
override this.Write : string -> unit
Public Overridable Sub Write (value As String)
Parámetros
- value
- String
Cadena que se va a escribir.
Excepciones
La clase TextWriter está cerrada.
Error de E/S.
Comentarios
Esta sobrecarga es equivalente a la Write(Char[]) sobrecarga.
Este método no busca en la cadena especificada caracteres de nueva línea individuales (0x000a hexadecimal) y los reemplaza por TextWriter.NewLine.
Si value
es null
, no se escribirá nada en la secuencia de texto.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- Write(String)
- Write(String)
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(Single)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe la representación de texto de un valor de punto flotante de 4 bytes en la secuencia de texto.
public:
virtual void Write(float value);
public virtual void Write (float value);
abstract member Write : single -> unit
override this.Write : single -> unit
Public Overridable Sub Write (value As Single)
Parámetros
- value
- Single
Valor de punto flotante de 4 bytes que se va a escribir.
Excepciones
La clase TextWriter está cerrada.
Error de E/S.
Comentarios
La representación de texto del valor especificado se genera mediante una llamada al Single.ToString método . La TextWriter.FormatProvider propiedad, si no null
es , especifica el formato específico de la referencia cultural.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- StreamWriter
- StringWriter
- IFormatProvider
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(String, Object, Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe una cadena con formato en la secuencia de texto con la misma semántica que el método Format(String, Object, Object).
public:
virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void Write (string format, object arg0, object arg1);
public virtual void Write (string format, object? arg0, object? arg1);
abstract member Write : string * obj * obj -> unit
override this.Write : string * obj * obj -> unit
Public Overridable 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.
Excepciones
format
es null
.
La clase TextWriter está cerrada.
Error de E/S.
format
no es una cadena de formato compuesta.
o bien
El índice de un elemento de formato es menor que 0 (cero) o mayor o igual que el número de objetos a los que se va a dar formato (que, para esta sobrecarga del método, es dos).
Comentarios
Este método usa formato compuesto para convertir el valor de un objeto en su representación de cadena e insertar esa representación en una cadena. .NET proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los temas de formato siguientes:
Para obtener más información sobre la característica de formato compuesto, consulte Formato compuesto.
Para obtener más información sobre los especificadores de formato numérico, vea Cadenas de formato numérico estándar y Cadenas de formato numérico personalizado.
Para obtener más información sobre los especificadores de formato de fecha y hora, vea Cadenas de formato de fecha y hora estándar y cadenas de formato de fecha y hora personalizados.
Para obtener más información sobre los especificadores de formato de enumeración, vea Cadenas de formato de enumeración.
Para obtener más información sobre el formato, vea Tipos de formato.
El format
parámetro consta de cero o más ejecuciones de texto entremezcladas con cero o más marcadores de posición indexados, denominados elementos de formato, que corresponden a un objeto de la lista de parámetros de este método. El proceso de formato reemplaza cada elemento de formato por la representación de cadena del valor del objeto correspondiente.
La sintaxis de un elemento de formato es la siguiente:
{index[,length][:formatString]}
Los elementos entre corchetes son opcionales. En esta tabla se describe cada elemento. Para obtener más información sobre la característica de formato compuesto, incluida la sintaxis de un elemento de formato, vea Formato compuesto.
Elemento | Descripción |
---|---|
índice | Posición de base cero en la lista de parámetros del objeto al que se va a dar formato. Si el objeto especificado por índice es null , el elemento de formato se reemplaza por String.Empty. Dado que esta sobrecarga tiene dos objetos en su lista de parámetros, el valor del índice siempre debe ser 0 o 1. Si no hay ningún parámetro en la posición de índice , se produce una FormatException excepción . |
,length | Número mínimo de caracteres en la representación de cadena del parámetro. Si es positivo, el parámetro está alineado a la derecha; si es negativo, está alineado a la izquierda. |
:formatString | Cadena de formato estándar o personalizado compatible con el objeto al que se va a dar formato. Los valores posibles para formatString son los mismos que los valores admitidos por el método del ToString(string format) objeto. Si no se especifica formatString y el objeto al que se va a dar formato implementa la IFormattable interfaz, null se pasa como el valor del format parámetro que se usa como cadena de IFormattable.ToString formato. |
Se requieren los caracteres de llave inicial y final, "{" y "}". Para especificar un carácter de llave literal único en format
, especifique dos caracteres de llave inicial o final; es decir, "{{" o "}}".
Este método no busca en la cadena especificada caracteres de nueva línea individuales (0x000a hexadecimal) y los reemplaza por TextWriter.NewLine.
Si no se hace referencia a un objeto especificado en la cadena de formato, se omite.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- StreamWriter
- StringWriter
- IFormatProvider
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe la representación de texto de un objeto en la secuencia de texto mediante una llamada al método ToString
en ese objeto.
public:
virtual void Write(System::Object ^ value);
public virtual void Write (object value);
public virtual void Write (object? value);
abstract member Write : obj -> unit
override this.Write : obj -> unit
Public Overridable Sub Write (value As Object)
Parámetros
- value
- Object
Objeto que se va a escribir.
Excepciones
La clase TextWriter está cerrada.
Error de E/S.
Comentarios
Esta sobrecarga es equivalente a la Write(String) sobrecarga.
Si el objeto especificado es null
, no se realiza ninguna acción y no se produce ninguna excepción. De lo contrario, se llama al método del ToString
objeto para generar la representación de cadena y la cadena resultante se escribe en el flujo de salida. La FormatProvider propiedad, si no null
es , especifica el formato específico de la referencia cultural.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- StreamWriter
- StringWriter
- IFormatProvider
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(Int64)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe la representación de texto de un entero con signo de 8 bytes en la secuencia de texto.
public:
virtual void Write(long value);
public virtual void Write (long value);
abstract member Write : int64 -> unit
override this.Write : int64 -> unit
Public Overridable Sub Write (value As Long)
Parámetros
- value
- Int64
Entero de 8 bytes con signo que se va a escribir.
Excepciones
La clase TextWriter está cerrada.
Error de E/S.
Comentarios
La representación de texto del valor especificado se genera mediante una llamada al Int64.ToString método . La TextWriter.FormatProvider propiedad, si no null
es , especifica el formato específico de la referencia cultural.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Cómo: Escribir texto en un archivo
Consulte también
Se aplica a
Write(Int32)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe la representación de texto de un entero con signo de 4 bytes en la secuencia de texto.
public:
virtual void Write(int value);
public virtual void Write (int value);
abstract member Write : int -> unit
override this.Write : int -> unit
Public Overridable Sub Write (value As Integer)
Parámetros
- value
- Int32
Entero de 4 bytes con signo que se va a escribir.
Excepciones
La clase TextWriter está cerrada.
Error de E/S.
Comentarios
La representación de texto del valor especificado se genera mediante una llamada al Int32.ToString método . La TextWriter.FormatProvider propiedad, si no null
es , especifica el formato específico de la referencia cultural.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- StreamWriter
- StringWriter
- IFormatProvider
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(Double)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe la representación de texto de un punto flotante de 8 bytes en la secuencia de texto.
public:
virtual void Write(double value);
public virtual void Write (double value);
abstract member Write : double -> unit
override this.Write : double -> unit
Public Overridable Sub Write (value As Double)
Parámetros
- value
- Double
Valor de punto flotante de 8 bytes que se va a escribir.
Excepciones
La clase TextWriter está cerrada.
Error de E/S.
Comentarios
La representación de texto del valor especificado se genera mediante una llamada al Double.ToString método . La TextWriter.FormatProvider propiedad, si no null
es , especifica el formato específico de la referencia cultural.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- StreamWriter
- StringWriter
- IFormatProvider
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(Decimal)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe la representación de texto de un valor decimal en la secuencia de texto.
public:
virtual void Write(System::Decimal value);
public virtual void Write (decimal value);
abstract member Write : decimal -> unit
override this.Write : decimal -> unit
Public Overridable Sub Write (value As Decimal)
Parámetros
- value
- Decimal
Valor decimal que se va a escribir.
Excepciones
La clase TextWriter está cerrada.
Error de E/S.
Comentarios
La FormatProvider propiedad, si no null
es , especifica el formato específico de la referencia cultural.
Consulte también
- StreamWriter
- StringWriter
- IFormatProvider
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(Char[])
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe una matriz de caracteres en la secuencia de texto.
public:
virtual void Write(cli::array <char> ^ buffer);
public virtual void Write (char[] buffer);
public virtual void Write (char[]? buffer);
abstract member Write : char[] -> unit
override this.Write : char[] -> unit
Public Overridable Sub Write (buffer As Char())
Parámetros
- buffer
- Char[]
Matriz de caracteres que se va a escribir en la secuencia de texto.
Excepciones
La clase TextWriter está cerrada.
Error de E/S.
Comentarios
Este método no busca en la cadena especificada caracteres de nueva línea individuales (0x000a hexadecimal) y los reemplaza por NewLine.
Este método predeterminado llama al Write(Char[], Int32, Int32) método y pasa toda la matriz de caracteres. Si la matriz de caracteres es null
, no se escribe nada.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- Write(Char[])
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(Char)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe un carácter en la secuencia de texto.
public:
abstract void Write(char value);
public:
virtual void Write(char value);
public abstract void Write (char value);
public virtual void Write (char value);
abstract member Write : char -> unit
abstract member Write : char -> unit
override this.Write : char -> unit
Public MustOverride Sub Write (value As Char)
Public Overridable Sub Write (value As Char)
Parámetros
- value
- Char
Carácter que se va a escribir en la secuencia de texto.
Excepciones
La clase TextWriter está cerrada.
Error de E/S.
Comentarios
Este método predeterminado no hace nada, pero las clases derivadas pueden invalidar el método para proporcionar la funcionalidad adecuada.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- Write(Char)
- Write(Char)
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(Boolean)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe la representación de texto de un valor Boolean
en la secuencia de texto.
public:
virtual void Write(bool value);
public virtual void Write (bool value);
abstract member Write : bool -> unit
override this.Write : bool -> unit
Public Overridable Sub Write (value As Boolean)
Parámetros
- value
- Boolean
Valor Boolean
que se va a escribir.
Excepciones
La clase TextWriter está cerrada.
Error de E/S.
Comentarios
La representación de texto del valor especificado se genera mediante una llamada al Boolean.ToString método .
Este método genera o Boolean.TrueStringBoolean.FalseString.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Consulte también
- StreamWriter
- StringWriter
- E/S de archivos y secuencias
- Cómo: Leer texto de un archivo
- Cómo: Escribir texto en un archivo
Se aplica a
Write(ReadOnlySpan<Char>)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Escribe un intervalo de caracteres en la secuencia de texto.
public:
virtual void Write(ReadOnlySpan<char> buffer);
public virtual void Write (ReadOnlySpan<char> buffer);
abstract member Write : ReadOnlySpan<char> -> unit
override this.Write : ReadOnlySpan<char> -> unit
Public Overridable Sub Write (buffer As ReadOnlySpan(Of Char))
Parámetros
- buffer
- ReadOnlySpan<Char>
Intervalo de caracteres que se va a escribir.
Comentarios
La representación de texto del valor especificado se genera llamando al carácter> ReadOnlySpan<. Método ToString.
Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.
Se aplica a
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta:Enviar y ver comentarios de