FileStream.WriteByte(Byte) Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

FileStream.cs

Dosya akışındaki geçerli konuma bir bayt yazar.

public:
 override void WriteByte(System::Byte value);

public override void WriteByte(byte value);

override this.WriteByte : byte -> unit

Public Overrides Sub WriteByte (value As Byte)

Parametreler

value

Byte

Akışa yazmak için bir bayt.

Özel durumlar

ObjectDisposedException

Akış kapatıldı.

NotSupportedException

Akış yazmayı desteklemiyor.

IOException

.NET 8 ve sonraki sürümleri: Temel alınan boru kapatılır veya bağlantısı kesilir.

Örnekler

Aşağıdaki kod örneğinde, bir dosyaya bayt bayt veri yazma ve ardından verilerin doğru yazıldığını doğrulama gösterilmektedir.

using System;
using System.IO;

class FStream
{
    static void Main()
    {
        const string fileName = "Test#@@#.dat";

        // Create random data to write to the file.
        byte[] dataArray = new byte[100000];
        new Random().NextBytes(dataArray);

        using(FileStream
            fileStream = new FileStream(fileName, FileMode.Create))
        {
            // Write the data to the file, byte by byte.
            for(int i = 0; i < dataArray.Length; i++)
            {
                fileStream.WriteByte(dataArray[i]);
            }

            // Set the stream position to the beginning of the file.
            fileStream.Seek(0, SeekOrigin.Begin);

            // Read and verify the data.
            for(int i = 0; i < fileStream.Length; i++)
            {
                if(dataArray[i] != fileStream.ReadByte())
                {
                    Console.WriteLine("Error writing data.");
                    return;
                }
            }
            Console.WriteLine("The data was written to {0} " +
                "and verified.", fileStream.Name);
        }
    }
}

open System
open System.IO


let fileName = "Test#@@#.dat"

// Create random data to write to the file.
let dataArray = Array.zeroCreate 100000
Random.Shared.NextBytes dataArray

do
    use fileStream = new FileStream(fileName, FileMode.Create)
    // Write the data to the file, byte by byte.
    for i = 0 to dataArray.Length - 1 do
        fileStream.WriteByte dataArray[i]

    // Set the stream position to the beginning of the file.
    fileStream.Seek(0, SeekOrigin.Begin) |> ignore

    // Read and verify the data.
    for i in 0L .. fileStream.Length - 1L do
        if dataArray[int i] <> (fileStream.ReadByte() |> byte) then
            printfn "Error writing data."
            exit 1

    printfn $"The data was written to {fileStream.Name} and verified."

Imports System.IO
Imports System.Text

Class FStream

    Shared Sub Main()

        Const fileName As String = "Test#@@#.dat"

        ' Create random data to write to the file.
        Dim dataArray(100000) As Byte
        Dim randomGenerator As New Random()
        randomGenerator.NextBytes(dataArray)

        Dim fileStream As FileStream = _
            new FileStream(fileName, FileMode.Create)
        Try

            ' Write the data to the file, byte by byte.
            For i As Integer = 0 To dataArray.Length - 1
                fileStream.WriteByte(dataArray(i))
            Next i

            ' Set the stream position to the beginning of the stream.
            fileStream.Seek(0, SeekOrigin.Begin)

            ' Read and verify the data.
            For i As Integer = 0 To _
                CType(fileStream.Length, Integer) - 1

                If dataArray(i) <> fileStream.ReadByte() Then
                    Console.WriteLine("Error writing data.")
                    Return
                End If
            Next i
            Console.WriteLine("The data was written to {0} " & _
                "and verified.", fileStream.Name)
        Finally
            fileStream.Close()
        End Try
    
    End Sub
End Class

Açıklamalar

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

Verimli bir şekilde bayt yazmak için FileStream kullanınWriteByte. Akış kapatılırsa veya yazılamazsa, bir özel durum oluşturulur.

Uyarı

CanWrite Geçerli örneğin yazmayı destekleyip desteklemediğini belirlemek için özelliğini kullanın. Ek bilgi için bkz. CanWrite.

Devralanlara Notlar

üzerindeki Stream varsayılan uygulama yeni bir tek baytlık dizi oluşturur ve ardından öğesini çağırır Write(Byte[], Int32, Int32). Bu resmi olarak doğru olsa da, verimsizdir. İç arabelleğe sahip herhangi bir akış bu yöntemi geçersiz kılmalı ve her çağrıda ek dizi ayırmayı önleyerek arabelleeği doğrudan okuyan çok daha verimli bir sürüm sağlamalıdır.

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

Ayrıca bkz.

• Dosya ve Akış G/Ç'si
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Dosyaya Metin Yazma