CryptoStream.Read(Byte[], Int32, Int32) 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í.
Lee una secuencia de bytes en el flujo actual y avanza la posición en el flujo según el número de bytes leídos.
public:
override int Read(cli::array <System::Byte> ^ buffer, int offset, int count);
public override int Read (byte[] buffer, int offset, int count);
override this.Read : byte[] * int * int -> int
Public Overrides Function Read (buffer As Byte(), offset As Integer, count As Integer) As Integer
Parámetros
- buffer
- Byte[]
Matriz de bytes. Se lee un máximo count
de bytes de la secuencia actual y se almacenan en buffer
.
- offset
- Int32
Posición de desplazamiento en bytes de buffer
donde se comienza a almacenar los datos leídos de la secuencia actual.
- count
- Int32
Número máximo de bytes que se deben leer de la secuencia actual.
Devoluciones
Número total de bytes leídos en el búfer. Puede ser menor que el número de bytes solicitado, si dicho número de bytes no está disponible en la actualidad, o cero, si se alcanza el final de la secuencia.
Excepciones
La enumeración CryptoStreamMode asociada al objeto CryptoStream actual no coincide con el flujo subyacente. Por ejemplo, esta excepción se produce al utilizar Read con un flujo subyacente que es de solo escritura.
offset
o count
es menor que cero.
La suma de los parámetros count
y offset
es mayor que la longitud del búfer.
Comentarios
A partir de .NET 6, este método podría no leer tantos bytes como se solicitaron. Para obtener más información, vea Lecturas parciales y de cero byte en DeflateStream, GZipStream y CryptoStream.