Stream.CopyTo Método
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í.
Lee los bytes de la secuencia actual y los escribe en otra secuencia. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados.
| CopyTo(Stream) |
Lee los bytes de la secuencia actual y los escribe en otra secuencia. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados. |
| CopyTo(Stream, Int32) |
Lee los bytes de la secuencia actual y los escribe en otra secuencia mediante un tamaño de búfer especificado. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados. |
- Source:
- Stream.cs
- Source:
- Stream.cs
- Source:
- Stream.cs
Lee los bytes de la secuencia actual y los escribe en otra secuencia. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados.
public:
void CopyTo(System::IO::Stream ^ destination);public void CopyTo (System.IO.Stream destination);member this.CopyTo : System.IO.Stream -> unitPublic Sub CopyTo (destination As Stream)Parámetros
- destination
- Stream
Secuencia a la que se copiará el contenido de la secuencia actual.
Excepciones
destination es null.
La secuencia actual no admite la lectura.
-o-
destination no admite la escritura.
Se cerró la secuencia actual o destination antes de llamar al método CopyTo(Stream).
Error de E/S.
Ejemplos
En el ejemplo siguiente se copia el contenido de un FileStream en un MemoryStream.
// Create the streams.
MemoryStream destination = new MemoryStream();
using (FileStream source = File.Open(@"c:\temp\data.dat",
FileMode.Open))
{
Console.WriteLine("Source length: {0}", source.Length.ToString());
// Copy source to destination.
source.CopyTo(destination);
}
Console.WriteLine("Destination length: {0}", destination.Length.ToString());
' Create the streams.
Dim destination As New MemoryStream()
Using source As FileStream = File.Open("c:\temp\data.dat", _
FileMode.Open)
Console.WriteLine("Source length: {0}", source.Length.ToString())
' Copy source to destination.
source.CopyTo(destination)
End Using
Console.WriteLine("Destination length: {0}", destination.Length.ToString())
Comentarios
La copia comienza en la posición actual de la secuencia actual y no restablece la posición de la secuencia de destino una vez completada la operación de copia.
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 | 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 |
- Source:
- Stream.cs
- Source:
- Stream.cs
- Source:
- Stream.cs
Lee los bytes de la secuencia actual y los escribe en otra secuencia mediante un tamaño de búfer especificado. Ambas posiciones de secuencias están avanzadas por el número de bytes copiados.
public:
void CopyTo(System::IO::Stream ^ destination, int bufferSize);public:
virtual void CopyTo(System::IO::Stream ^ destination, int bufferSize);public void CopyTo (System.IO.Stream destination, int bufferSize);public virtual void CopyTo (System.IO.Stream destination, int bufferSize);member this.CopyTo : System.IO.Stream * int -> unitabstract member CopyTo : System.IO.Stream * int -> unit
override this.CopyTo : System.IO.Stream * int -> unitPublic Sub CopyTo (destination As Stream, bufferSize As Integer)Public Overridable Sub CopyTo (destination As Stream, bufferSize As Integer)Parámetros
- destination
- Stream
Secuencia a la que se copiará el contenido de la secuencia actual.
- bufferSize
- Int32
Tamaño del búfer. Este valor debe ser mayor que cero. El tamaño predeterminado es 81920.
Excepciones
destination es null.
bufferSize es negativo o cero.
La secuencia actual no admite la lectura.
-o-
destination no admite la escritura.
Se cerró la secuencia actual o destination antes de llamar al método CopyTo(Stream).
Error de E/S.
Comentarios
La copia comienza en la posición actual de la secuencia actual y no restablece la posición de la secuencia de destino una vez completada la operación de copia.
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 | 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 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: