FileStream.Read Yöntem

Tanım

Aşırı Yüklemeler

Read(Byte[], Int32, Int32)

Akıştan bir bayt bloğu okur ve verileri belirli bir arabelleğe yazar.

Read(Span<Byte>)

Geçerli dosya akışından bir bayt dizisi okur ve dosya akışındaki konumu okunan bayt sayısına göre ilerler.

Read(Byte[], Int32, Int32)

Kaynak:
FileStream.cs
Kaynak:
FileStream.cs
Kaynak:
FileStream.cs

Akıştan bir bayt bloğu okur ve verileri belirli bir arabelleğe yazar.

C#
public override int Read (byte[] array, int offset, int count);
C#
public override int Read (byte[] buffer, int offset, int count);

Parametreler

arraybuffer
Byte[]

Bu yöntem döndürdüğünde, belirtilen bayt dizisini ve (countoffset + - 1) arasındaki offset değerleri geçerli kaynaktan okunan baytlarla değiştirerek içerir.

offset
Int32

Okuma baytlarının yerleştirileceği bayt uzaklığı array .

count
Int32

Okunacak bayt sayısı üst sınırı.

Döndürülenler

Arabelleğe okunan toplam bayt sayısı. Bu, şu anda kullanılabilir bayt sayısı yoksa istenen bayt sayısından az veya akışın sonuna ulaşılırsa sıfır olabilir.

Özel durumlar

array, null değeridir.

offset veya count negatiftir.

Akış okumayı desteklemiyor.

G/ç hatası oluştu.

offset ve count içinde geçersiz bir aralık açıklayın array.

Akış kapatıldıktan sonra yöntemler çağrıldı.

Örnekler

Aşağıdaki örnek içindekileri okur ve başka bir FileStreamFileStreamöğesine yazar.

C#
using System;
using System.IO;

class Test
{

public static void Main()
{
    // Specify a file to read from and to create.
    string pathSource = @"c:\tests\source.txt";
    string pathNew = @"c:\tests\newfile.txt";

    try
    {

        using (FileStream fsSource = new FileStream(pathSource,
            FileMode.Open, FileAccess.Read))
        {

            // Read the source file into a byte array.
            byte[] bytes = new byte[fsSource.Length];
            int numBytesToRead = (int)fsSource.Length;
            int numBytesRead = 0;
            while (numBytesToRead > 0)
            {
                // Read may return anything from 0 to numBytesToRead.
                int n = fsSource.Read(bytes, numBytesRead, numBytesToRead);

                // Break when the end of the file is reached.
                if (n == 0)
                    break;

                numBytesRead += n;
                numBytesToRead -= n;
            }
             numBytesToRead = bytes.Length;

            // Write the byte array to the other FileStream.
            using (FileStream fsNew = new FileStream(pathNew,
                FileMode.Create, FileAccess.Write))
            {
                fsNew.Write(bytes, 0, numBytesToRead);
            }
        }
    }
    catch (FileNotFoundException ioEx)
    {
        Console.WriteLine(ioEx.Message);
    }
}
}

Açıklamalar

Bu yöntem geçersiz kılar Read.

offset parametresi, okunmaya başlanacak bayt uzaklığını array (arabellek dizini) verir ve count parametresi bu akıştan okunacak bayt sayısı üst sınırını verir. Döndürülen değer okunan gerçek bayt sayısıdır veya akışın sonuna ulaşılırsa sıfırdır. Okuma işlemi başarılı olursa, akışın geçerli konumu okunan bayt sayısıyla gelişmiştir. Bir özel durum oluşursa, akışın geçerli konumu değişmez.

Read yöntemi yalnızca akışın sonuna ulaştıktan sonra sıfır döndürür. Aksi takdirde, Read döndürmeden önce her zaman akıştan en az bir bayt okur. çağrısı Readüzerine akıştan veri yoksa, yöntem en az bir bayt veri döndürülene kadar engeller. Bir uygulama, akışın sonuna ulaşılmasa bile istenenden daha az bayt döndürmek için ücretsizdir.

Temel veri türlerini okumak için kullanın BinaryReader .

Okuma işlemi gerçekleştiren bir iş parçacığını kesintiye uğratmayın. İş parçacığı engeli kaldırıldıktan sonra uygulama başarıyla çalışıyor gibi görünse de, kesinti uygulamanızın performansını ve güvenilirliğini azaltabilir.

Yaygın dosya ve dizin işlemlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Read(Span<Byte>)

Kaynak:
FileStream.cs
Kaynak:
FileStream.cs
Kaynak:
FileStream.cs

Geçerli dosya akışından bir bayt dizisi okur ve dosya akışındaki konumu okunan bayt sayısına göre ilerler.

C#
public override int Read (Span<byte> buffer);

Parametreler

buffer
Span<Byte>

Bellek bölgesi. Bu yöntem döndürdüğünde, bu bölgenin içeriği geçerli dosya akışından okunan baytlar ile değiştirilir.

Döndürülenler

Arabelleğe okunan toplam bayt sayısı. Bu, arabellekte ayrılan bayt sayısından az veya akışın sonuna ulaşıldıysa sıfır (0) olabilir.

Açıklamalar

CanRead Geçerli örneğin okumayı destekleyip desteklemediğini belirlemek için özelliğini kullanın. ReadAsync Geçerli akıştan zaman uyumsuz olarak okumak için yöntemini kullanın.

Bu yöntem geçerli dosya akışından en fazla buffer.Length bayt sayısını okur ve içinde bufferdepolar. Dosya akışındaki geçerli konum, okunan bayt sayısıyla gelişmiştir; ancak bir özel durum oluşursa, dosya akışındaki geçerli konum değişmeden kalır. Yöntem, kullanılabilir veri olmaması durumunda en az bir bayt veri okunana kadar engeller. Read yalnızca dosya akışında daha fazla veri olmadığında ve başka veri beklenmezse (kapalı yuva veya dosya sonu gibi) 0 döndürür. Dosya akışının sonuna ulaşılmasa bile yöntemi istenenden daha az bayt döndüremeyebilir.

Temel veri türlerini okumak için kullanın BinaryReader .

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1