RandomAccess.ReadAsync Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Aşırı Yüklemeler

ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)	Belirli bir uzaklıkta verilen dosyadan bir bayt dizisi okur.
ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)	Belirli bir uzaklıkta verilen dosyadan bir bayt dizisi okur.

ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)

Kaynak:

RandomAccess.cs

Belirli bir uzaklıkta verilen dosyadan bir bayt dizisi okur.

public static System.Threading.Tasks.ValueTask<long> ReadAsync (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<Memory<byte>> buffers, long fileOffset, System.Threading.CancellationToken cancellationToken = default);

static member ReadAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<Memory<byte>> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int64>

Public Shared Function ReadAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Long)

Parametreler

handle

SafeFileHandle

Dosya tanıtıcısı.

buffers

IReadOnlyList<Memory<Byte>>

Bellek arabelleklerinin listesi. Bu yöntem döndürdüğünde, bu arabelleklerin içeriği dosyadan okunan baytlarla değiştirilir.

fileOffset

Int64

Okunacak dosya konumu.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç. None varsayılan değerdir.

Döndürülenler

ValueTask<Int64>

Arabelleklere okunan toplam bayt sayısı. Bu, şu anda kullanılabilir sayıda bayt yoksa arabelleklerde ayrılan bayt sayısından az veya dosyanın sonuna ulaşıldıysa sıfır (0) olabilir.

Özel durumlar

ArgumentNullException

handle veya buffers şeklindedir null.

ArgumentException

handle geçersizdir.

ObjectDisposedException

Dosya kapatılır.

NotSupportedException

Dosya aramayı (kanal veya yuva) desteklemiyor.

ArgumentOutOfRangeException

fileOffset negatiftir.

UnauthorizedAccessException

handle okunmaya açılmadı.

IOException

G/ç hatası oluştu.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Dosyanın konumu gelişmiş değil.

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)özel durumlara bakın.

ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)

Kaynak:

RandomAccess.cs

Belirli bir uzaklıkta verilen dosyadan bir bayt dizisi okur.

public static System.Threading.Tasks.ValueTask<int> ReadAsync (Microsoft.Win32.SafeHandles.SafeFileHandle handle, Memory<byte> buffer, long fileOffset, System.Threading.CancellationToken cancellationToken = default);

static member ReadAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * Memory<byte> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Shared Function ReadAsync (handle As SafeFileHandle, buffer As Memory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parametreler

handle

SafeFileHandle

Dosya tanıtıcısı.

buffer

Memory<Byte>

Bellek bölgesi. Bu yöntem döndürdüğünde, bu bölgenin içeriği dosyadan okunan bayt ile değiştirilir.

fileOffset

Int64

Okunacak dosya konumu.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç. None varsayılan değerdir.

Döndürülenler

ValueTask<Int32>

Arabelleğe okunan toplam bayt sayısı. Bu, şu anda kullanılabilir sayıda bayt yoksa arabellekte ayrılan bayt sayısından az veya dosyanın sonuna ulaşıldıysa sıfır (0) olabilir.

Özel durumlar

ArgumentNullException

handle, null değeridir.

ArgumentException

handle geçersizdir.

ObjectDisposedException

Dosya kapatılır.

NotSupportedException

Dosya aramayı (kanal veya yuva) desteklemiyor.

ArgumentOutOfRangeException

fileOffset negatiftir.

UnauthorizedAccessException

handle okunmaya açılmadı.

IOException

G/ç hatası oluştu.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Dosyanın konumu gelişmiş değil.