RandomAccess.Read Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64) |
Lê uma sequência de bytes do ficheiro dado no deslocamento indicado. |
| Read(SafeFileHandle, Span<Byte>, Int64) |
Lê uma sequência de bytes do ficheiro dado no deslocamento indicado. |
Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
Lê uma sequência de bytes do ficheiro dado no deslocamento indicado.
public:
static long Read(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::Collections::Generic::IReadOnlyList<Memory<System::Byte>> ^ buffers, long fileOffset);public static long Read(Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<Memory<byte>> buffers, long fileOffset);static member Read : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<Memory<byte>> * int64 -> int64Public Shared Function Read (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long) As LongParâmetros
- handle
- SafeFileHandle
A alça do ficheiro.
- buffers
- IReadOnlyList<Memory<Byte>>
Uma lista de buffers de memória. Quando este método retorna, o conteúdo dos buffers é substituído pelos bytes lidos do ficheiro.
- fileOffset
- Int64
A posição do ficheiro para ler.
Devoluções
O número total de bytes lidos nos buffers. Isto pode ser inferior ao número de bytes alocados nos buffers se esse número de bytes não estiver disponível no momento, ou zero (0) se o fim do ficheiro for alcançado.
Exceções
handle ou buffers é null.
handle é inválido.
O processo está encerrado.
O ficheiro não suporta busca (pipe ou socket).
fileOffset é negativo.
handle não estava aberto para leitura.
Ocorreu um erro de I/O.
Observações
A posição do dossier não está avançada.
Aplica-se a
Read(SafeFileHandle, Span<Byte>, Int64)
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
- Origem:
- RandomAccess.cs
Lê uma sequência de bytes do ficheiro dado no deslocamento indicado.
public:
static int Read(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, Span<System::Byte> buffer, long fileOffset);public static int Read(Microsoft.Win32.SafeHandles.SafeFileHandle handle, Span<byte> buffer, long fileOffset);static member Read : Microsoft.Win32.SafeHandles.SafeFileHandle * Span<byte> * int64 -> intPublic Shared Function Read (handle As SafeFileHandle, buffer As Span(Of Byte), fileOffset As Long) As IntegerParâmetros
- handle
- SafeFileHandle
A alça do ficheiro.
Uma região da memória. Quando este método retorna, o conteúdo desta região é substituído pelos bytes lidos do ficheiro.
- fileOffset
- Int64
A posição do ficheiro para ler.
Devoluções
O número total de bytes lidos no buffer. Isto pode ser inferior ao número de bytes alocados no buffer se esse número de bytes não estiverem disponíveis no momento, ou zero (0) se o fim do ficheiro for atingido.
Exceções
handle é null.
handle é inválido.
O processo está encerrado.
O ficheiro não suporta busca (pipe ou socket).
fileOffset é negativo.
handle não estava aberto para leitura.
Ocorreu um erro de I/O.
Observações
A posição do dossier não está avançada.
