StringWriter.Write Método

Referencia

Definición

Espacio de nombres:: System.IO

Ensamblado:: System.IO.dll

Ensamblado:: System.Runtime.dll

Ensamblado:: System.Runtime.Extensions.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.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 cadena.

Sobrecargas

Write(Char[], Int32, Int32)	Escribe una submatriz de caracteres en la cadena.
Write(String)	Escribe una cadena en la cadena actual.
Write(StringBuilder)	Escribe la representación en forma de cadena de un generador de cadena en la cadena actual.
Write(Char)	Escribe un carácter en la cadena.
Write(ReadOnlySpan<Char>)	Escribe la representación en forma de cadena de un intervalo de caracteres en la cadena actual.

Write(Char[], Int32, Int32)

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

Escribe una submatriz de caracteres en la cadena.

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 de la que se escriben los datos.

index: Int32

Posición 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.

ArgumentOutOfRangeException

index o count es negativo.

ArgumentException

(index + count)>buffer. Length.

ObjectDisposedException

El sistema de escritura está cerrado.

Ejemplos

Este ejemplo de código forma parte de un ejemplo más grande proporcionado para el StringWriter() constructor.

// Use the three overloads of the Write method that are 
// overridden by the StringWriter class.
strWriter->Write( "file path characters are: " );
strWriter->Write( Path::InvalidPathChars, 0, Path::InvalidPathChars->Length );
strWriter->Write( Char::Parse( "." ) );

// Use the three overloads of the Write method that are
// overridden by the StringWriter class.
strWriter.Write("file path characters are: ");
strWriter.Write(
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length);
strWriter.Write('.');

' Use the three overloads of the Write method that are 
' overridden by the StringWriter class.
strWriter.Write("file path characters are: ")
strWriter.Write( _
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length)
strWriter.Write("."C)

Comentarios

Este método invalida TextWriter.Write.

Este método escribe count caracteres de datos en este StringWriter desde buffer, empezando por la posición index.

En la tabla siguiente se enumeran ejemplos de otras tareas de E/S típicas o relacionadas.

Para...	Vea el ejemplo de este tema...
Crear un archivo de texto	Cómo: Escribir texto en un archivo
Escribir en un archivo de texto.	Cómo: Escribir texto en un archivo
Lee desde un archivo de texto.	Cómo: Leer texto de un archivo
Anexar texto a un archivo.	Cómo: Abrir y anexar a un archivo de registro File.AppendText FileInfo.AppendText
Obtiene el tamaño de un archivo.	FileInfo.Length
Obtenga los atributos de un archivo.	File.GetAttributes
Establezca los atributos de un archivo.	File.SetAttributes
Determine si existe un archivo.	File.Exists
Lee desde un archivo binario.	Cómo: Leer y escribir en un archivo de datos recién creado
Escriba en un archivo binario.	Cómo: Leer y escribir en un archivo de datos recién creado

Consulte también

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(String)

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

Escribe una cadena en la cadena actual.

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.

Excepciones

ObjectDisposedException

El sistema de escritura está cerrado.

Ejemplos

Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase StringWriter.

convertedCharacter = Convert::ToChar( intCharacter );
if ( convertedCharacter == '.' )
{
   strWriter->Write(  ".\n\n" );
   
   // Bypass the spaces between sentences.
   strReader->Read();
   strReader->Read();
}

convertedCharacter = (char)intCharacter;
if(convertedCharacter == '.')
{
    strWriter.Write(".\n\n");

    // Bypass the spaces between sentences.
    strReader.Read();
    strReader.Read();
}

convertedCharacter = Convert.ToChar(intCharacter)
If convertedCharacter = "."C Then
    strWriter.Write("." & vbCrLf & vbCrLf)

    ' Bypass the spaces between sentences.
    strReader.Read()
    strReader.Read()

Comentarios

Este método invalida TextWriter.Write.

Si la cadena especificada es null, no se escribe nada.

En la tabla siguiente se enumeran ejemplos de otras tareas de E/S típicas o relacionadas.

Para...	Vea el ejemplo de este tema...
Crear un archivo de texto	Cómo: Escribir texto en un archivo
Escribir en un archivo de texto.	Cómo: Escribir texto en un archivo
Lee desde un archivo de texto.	Cómo: Leer texto de un archivo
Anexar texto a un archivo.	Cómo: Abrir y anexar a un archivo de registro File.AppendText FileInfo.AppendText
Obtiene el tamaño de un archivo.	FileInfo.Length
Obtenga los atributos de un archivo.	File.GetAttributes
Establezca los atributos de un archivo.	File.SetAttributes
Determine si existe un archivo.	File.Exists
Lee desde un archivo binario.	Cómo: Leer y escribir en un archivo de datos recién creado
Escriba en un archivo binario.	Cómo: Leer y escribir en un archivo de datos recién creado

Consulte también

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(StringBuilder)

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

Escribe la representación en forma de cadena de un generador de cadena en la cadena actual.

public:
 override void Write(System::Text::StringBuilder ^ value);

public override void Write (System.Text.StringBuilder? value);

override this.Write : System.Text.StringBuilder -> unit

Public Overrides Sub Write (value As StringBuilder)

Parámetros

value: StringBuilder

El generador de cadena que se va a escribir en la cadena.

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9

Write(Char)

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

Escribe un carácter en la cadena.

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.

Excepciones

ObjectDisposedException

El sistema de escritura está cerrado.

Ejemplos

Este ejemplo de código forma parte de un ejemplo más grande proporcionado para el StringWriter() constructor.

// Use the three overloads of the Write method that are 
// overridden by the StringWriter class.
strWriter->Write( "file path characters are: " );
strWriter->Write( Path::InvalidPathChars, 0, Path::InvalidPathChars->Length );
strWriter->Write( Char::Parse( "." ) );

// Use the three overloads of the Write method that are
// overridden by the StringWriter class.
strWriter.Write("file path characters are: ");
strWriter.Write(
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length);
strWriter.Write('.');

' Use the three overloads of the Write method that are 
' overridden by the StringWriter class.
strWriter.Write("file path characters are: ")
strWriter.Write( _
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length)
strWriter.Write("."C)

Comentarios

Este método invalida TextWriter.Write.

En la tabla siguiente se enumeran ejemplos de otras tareas de E/S típicas o relacionadas.

Para...	Vea el ejemplo de este tema...
Crear un archivo de texto	Cómo: Escribir texto en un archivo
Escribir en un archivo de texto.	Cómo: Escribir texto en un archivo
Lee desde un archivo de texto.	Cómo: Leer texto de un archivo
Anexar texto a un archivo.	Cómo: Abrir y anexar a un archivo de registro File.AppendText FileInfo.AppendText
Obtiene el tamaño de un archivo.	FileInfo.Length
Obtenga los atributos de un archivo.	File.GetAttributes
Establezca los atributos de un archivo.	File.SetAttributes
Determine si existe un archivo.	File.Exists
Lee desde un archivo binario.	Cómo: Leer y escribir en un archivo de datos recién creado
Escriba en un archivo binario.	Cómo: Leer y escribir en un archivo de datos recién creado

Consulte también

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Write(ReadOnlySpan<Char>)

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

Escribe la representación en forma de cadena de un intervalo de caracteres en la cadena actual.

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 en la cadena.

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

Compartir a través de

StringWriter.Write Método

Definición

Sobrecargas

Write(Char[], Int32, Int32)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Write(String)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Write(StringBuilder)

Parámetros

Se aplica a

Write(Char)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Write(ReadOnlySpan<Char>)

Parámetros

Se aplica a

Recursos adicionales