FileStream Kelas

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Sumber:

FileStream.cs

Menyediakan Stream untuk file, mendukung operasi baca dan tulis yang sinkron dan asinkron.

public ref class FileStream : System::IO::Stream

public class FileStream : System.IO.Stream

type FileStream = class
    inherit Stream

Public Class FileStream
Inherits Stream

Warisan

Object

MarshalByRefObject

Stream

FileStream

Turunan

System.IO.IsolatedStorage.IsolatedStorageFileStream

Contoh

Contoh berikut menunjukkan beberapa konstruktor FileStream.

using namespace System;
using namespace System::IO;
using namespace System::Text;

void AddText( FileStream^ fs, String^ value )
{
   array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( value );
   fs->Write( info, 0, info->Length );
}

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Delete the file if it exists.
   if ( File::Exists( path ) )
   {
      File::Delete( path );
   }

   //Create the file.
   {
      FileStream^ fs = File::Create( path );
      try
      {
         AddText( fs, "This is some text" );
         AddText( fs, "This is some more text," );
         AddText( fs, "\r\nand this is on a new line" );
         AddText( fs, "\r\n\r\nThe following is a subset of characters:\r\n" );
         for ( int i = 1; i < 120; i++ )
         {
            AddText( fs, Convert::ToChar( i ).ToString() );
            
            //Split the output at every 10th character.
            if ( Math::IEEERemainder( Convert::ToDouble( i ), 10 ) == 0 )
            {
               AddText( fs, "\r\n" );
            }
         }
      }
      finally
      {
         if ( fs )
            delete (IDisposable^)fs;
      }
   }
   
   //Open the stream and read it back.
   {
      FileStream^ fs = File::OpenRead( path );
      try
      {
         array<Byte>^b = gcnew array<Byte>(1024);
         UTF8Encoding^ temp = gcnew UTF8Encoding( true );
         while ( fs->Read( b, 0, b->Length ) > 0 )
         {
            Console::WriteLine( temp->GetString( b ) );
         }
      }
      finally
      {
         if ( fs )
            delete (IDisposable^)fs;
      }
   }
}

using System;
using System.IO;
using System.Text;

class Test
{

    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // Delete the file if it exists.
        if (File.Exists(path))
        {
            File.Delete(path);
        }

        //Create the file.
        using (FileStream fs = File.Create(path))
        {
            AddText(fs, "This is some text");
            AddText(fs, "This is some more text,");
            AddText(fs, "\r\nand this is on a new line");
            AddText(fs, "\r\n\r\nThe following is a subset of characters:\r\n");

            for (int i=1;i < 120;i++)
            {
                AddText(fs, Convert.ToChar(i).ToString());
            }
        }

        //Open the stream and read it back.
        using (FileStream fs = File.OpenRead(path))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);
            int readLen;
            while ((readLen = fs.Read(b,0,b.Length)) > 0)
            {
                Console.WriteLine(temp.GetString(b,0,readLen));
            }
        }
    }

    private static void AddText(FileStream fs, string value)
    {
        byte[] info = new UTF8Encoding(true).GetBytes(value);
        fs.Write(info, 0, info.Length);
    }
}

open System
open System.IO
open System.Text

let addText (fs:FileStream) (value: string) =
    let info = UTF8Encoding(true).GetBytes value
    fs.Write(info, 0, info.Length);

let path = @"c:\temp\MyTest.txt"

// Delete the file if it exists.
if File.Exists path then
    File.Delete path

//Create the file.
do
    use fs = File.Create path

    addText fs "This is some text"
    addText fs "This is some more text,"
    addText fs "\r\nand this is on a new line"
    addText fs "\r\n\r\nThe following is a subset of characters:\r\n"

    for i = 1 to 119 do
        Convert.ToChar i
        |> string
        |> addText fs
    
do
    //Open the stream and read it back.
    use fs = File.OpenRead path
    let b = Array.zeroCreate 1024
    let temp = UTF8Encoding true
    let mutable readLen = fs.Read(b,0,b.Length);
    while readLen> 0 do
        printfn $"{temp.GetString(b,0,readLen)}"
        readLen <- fs.Read(b,0,b.Length)

Imports System.IO
Imports System.Text

Public Class Test

    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        ' Delete the file if it exists.
        If File.Exists(path) Then
            File.Delete(path)
        End If

        'Create the file.
        Dim fs As FileStream = File.Create(path)

        AddText(fs, "This is some text")
        AddText(fs, "This is some more text,")
        AddText(fs, Environment.NewLine & "and this is on a new line")
        AddText(fs, Environment.NewLine & Environment.NewLine)
        AddText(fs, "The following is a subset of characters:" & Environment.NewLine)

        Dim i As Integer

        For i = 1 To 120
            AddText(fs, Convert.ToChar(i).ToString())

        Next

        fs.Close()

        'Open the stream and read it back.
        fs = File.OpenRead(path)
        Dim b(1023) As Byte
        Dim temp As UTF8Encoding = New UTF8Encoding(True)

        Do While fs.Read(b, 0, b.Length) > 0
            Console.WriteLine(temp.GetString(b))
        Loop

        fs.Close()
    End Sub

    Private Shared Sub AddText(ByVal fs As FileStream, ByVal value As String)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes(value)
        fs.Write(info, 0, info.Length)
    End Sub
End Class

Contoh berikut menunjukkan cara menulis ke file secara asinkron. Kode ini berjalan di aplikasi WPF yang memiliki TextBlock bernama UserInput dan tombol yang dikaitkan dengan penanganan aktivitas Klik yang bernama Button_Click. Jalur file perlu diubah ke file yang ada di komputer.

using System;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.IO;

namespace WpfApplication1
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private async void Button_Click(object sender, RoutedEventArgs e)
        {
            UnicodeEncoding uniencoding = new UnicodeEncoding();
            string filename = @"c:\Users\exampleuser\Documents\userinputlog.txt";

            byte[] result = uniencoding.GetBytes(UserInput.Text);

            using (FileStream SourceStream = File.Open(filename, FileMode.OpenOrCreate))
            {
                SourceStream.Seek(0, SeekOrigin.End);
                await SourceStream.WriteAsync(result, 0, result.Length);
            }
        }
    }
}

Imports System.IO
Imports System.Text

Class MainWindow
    Private Async Sub Button_Click(sender As Object, e As RoutedEventArgs)
        Dim uniencoding As UnicodeEncoding = New UnicodeEncoding()
        Dim filename As String = "c:\Users\exampleuser\Documents\userinputlog.txt"

        Dim result As Byte() = uniencoding.GetBytes(UserInput.Text)

        Using SourceStream As FileStream = File.Open(filename, FileMode.OpenOrCreate)
            SourceStream.Seek(0, SeekOrigin.End)
            Await SourceStream.WriteAsync(result, 0, result.Length)
        End Using
    End Sub
End Class

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat keterangan API Tambahan untuk FileStream.

Konstruktor

FileStream(IntPtr, FileAccess)	Kedaluwarsa. Menginisialisasi instans baru kelas FileStream untuk handel file yang ditentukan, dengan izin baca/tulis yang ditentukan.
FileStream(IntPtr, FileAccess, Boolean)	Kedaluwarsa. Menginisialisasi instans baru kelas FileStream untuk handel file yang ditentukan, dengan izin baca/tulis yang ditentukan dan kepemilikan instans FileStream.
FileStream(IntPtr, FileAccess, Boolean, Int32)	Kedaluwarsa. Menginisialisasi instans baru kelas FileStream untuk handel file yang ditentukan, dengan izin baca/tulis yang ditentukan, kepemilikan instans FileStream, dan ukuran buffer.
FileStream(IntPtr, FileAccess, Boolean, Int32, Boolean)	Kedaluwarsa. Menginisialisasi instans baru kelas FileStream untuk handel file yang ditentukan, dengan izin baca/tulis yang ditentukan, FileStream kepemilikan instans, ukuran buffer, dan status sinkron atau asinkron.
FileStream(SafeFileHandle, FileAccess)	Menginisialisasi instans baru kelas FileStream untuk handel file yang ditentukan, dengan izin baca/tulis yang ditentukan.
FileStream(SafeFileHandle, FileAccess, Int32)	Menginisialisasi instans baru kelas FileStream untuk handel file yang ditentukan, dengan izin baca/tulis yang ditentukan, dan ukuran buffer.
FileStream(SafeFileHandle, FileAccess, Int32, Boolean)	Menginisialisasi instans baru kelas FileStream untuk handel file yang ditentukan, dengan izin baca/tulis yang ditentukan, ukuran buffer, dan status sinkron atau asinkron.
FileStream(String, FileMode)	Menginisialisasi instans baru kelas FileStream dengan jalur dan mode pembuatan yang ditentukan.
FileStream(String, FileMode, FileAccess)	Menginisialisasi instans baru kelas FileStream dengan jalur yang ditentukan, mode pembuatan, dan izin baca/tulis.
FileStream(String, FileMode, FileAccess, FileShare)	Menginisialisasi instans baru kelas FileStream dengan jalur yang ditentukan, mode pembuatan, izin baca/tulis, dan izin berbagi.
FileStream(String, FileMode, FileAccess, FileShare, Int32)	Menginisialisasi instans baru kelas FileStream dengan jalur yang ditentukan, mode pembuatan, izin baca/tulis dan berbagi, dan ukuran buffer.
FileStream(String, FileMode, FileAccess, FileShare, Int32, Boolean)	Menginisialisasi instans baru kelas FileStream dengan jalur yang ditentukan, mode pembuatan, izin baca/tulis dan berbagi, ukuran buffer, dan status sinkron atau asinkron.
FileStream(String, FileMode, FileAccess, FileShare, Int32, FileOptions)	Menginisialisasi instans baru kelas FileStream dengan jalur yang ditentukan, mode pembuatan, izin baca/tulis dan berbagi, akses fileStream lain dapat memiliki file yang sama, ukuran buffer, dan opsi file tambahan.
FileStream(String, FileStreamOptions)	Menginisialisasi instans baru kelas FileStream dengan jalur yang ditentukan, mode pembuatan, izin baca/tulis dan berbagi, ukuran buffer, opsi file tambahan, ukuran pra-alokasi, dan akses fileStream lainnya dapat memiliki file yang sama.

Properti

CanRead	Mendapatkan nilai yang menunjukkan apakah aliran saat ini mendukung pembacaan.
CanSeek	Mendapatkan nilai yang menunjukkan apakah aliran saat ini mendukung pencarian.
CanTimeout	Mendapatkan nilai yang menentukan apakah aliran saat ini dapat kehabisan waktu. (Diperoleh dari Stream)
CanWrite	Mendapatkan nilai yang menunjukkan apakah aliran saat ini mendukung penulisan.
Handle	Kedaluwarsa. Mendapatkan handel file sistem operasi untuk file yang dienkapsulasi objek FileStream saat ini.
IsAsync	Mendapatkan nilai yang menunjukkan apakah FileStream dibuka secara asinkron atau sinkron.
Length	Mendapatkan panjang byte aliran.
Name	Mendapatkan jalur absolut file yang dibuka di FileStream.
Position	Mendapatkan atau mengatur posisi aliran ini saat ini.
ReadTimeout	Mendapatkan atau menetapkan nilai, dalam milidetik, yang menentukan berapa lama aliran akan mencoba membaca sebelum waktu habis. (Diperoleh dari Stream)
SafeFileHandle	Mendapatkan objek SafeFileHandle yang mewakili handel file sistem operasi untuk file yang dienkapsulasi objek FileStream saat ini.
WriteTimeout	Mendapatkan atau menetapkan nilai, dalam milidetik, yang menentukan berapa lama aliran akan mencoba menulis sebelum waktu habis. (Diperoleh dari Stream)

Metode

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	Memulai operasi baca asinkron. Pertimbangkan untuk menggunakan ReadAsync(Byte[], Int32, Int32, CancellationToken) sebagai gantinya.
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Memulai operasi penulisan asinkron. Pertimbangkan untuk menggunakan WriteAsync(Byte[], Int32, Int32, CancellationToken) sebagai gantinya.
Close()	Menutup aliran saat ini dan merilis sumber daya apa pun (seperti soket dan handel file) yang terkait dengan aliran saat ini. Alih-alih memanggil metode ini, pastikan aliran dibuang dengan benar. (Diperoleh dari Stream)
CopyTo(Stream)	Membaca byte dari aliran saat ini dan menulisnya ke aliran lain. Kedua posisi aliran dimajukan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyTo(Stream, Int32)	Membaca byte dari aliran saat ini dan menulisnya ke aliran lain, menggunakan ukuran buffer tertentu. Kedua posisi aliran dimajukan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyToAsync(Stream)	Secara asinkron membaca byte dari aliran saat ini dan menulisnya ke aliran lain. Kedua posisi aliran dimajukan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyToAsync(Stream, CancellationToken)	Secara asinkron membaca byte dari aliran saat ini dan menulisnya ke aliran lain, menggunakan token pembatalan tertentu. Kedua posisi aliran dimajukan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyToAsync(Stream, Int32)	Secara asinkron membaca byte dari aliran saat ini dan menulisnya ke aliran lain, menggunakan ukuran buffer tertentu. Kedua posisi aliran dimajukan dengan jumlah byte yang disalin. (Diperoleh dari Stream)
CopyToAsync(Stream, Int32, CancellationToken)	Secara asinkron membaca byte dari aliran file saat ini dan menulisnya ke aliran lain, menggunakan ukuran buffer dan token pembatalan yang ditentukan.
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
CreateWaitHandle()	Kedaluwarsa. Mengalokasikan objek WaitHandle. (Diperoleh dari Stream)
Dispose()	Merilis semua sumber daya yang digunakan oleh Stream. (Diperoleh dari Stream)
Dispose(Boolean)	Merilis sumber daya yang tidak dikelola yang digunakan oleh FileStream dan secara opsional merilis sumber daya terkelola.
DisposeAsync()	Secara asinkron merilis sumber daya yang tidak dikelola yang digunakan oleh FileStream.
EndRead(IAsyncResult)	Menunggu operasi baca asinkron yang tertunda selesai. (Pertimbangkan untuk menggunakan ReadAsync(Byte[], Int32, Int32, CancellationToken) sebagai gantinya.)
EndWrite(IAsyncResult)	Mengakhiri operasi tulis asinkron dan memblokir hingga operasi I/O selesai. (Pertimbangkan untuk menggunakan WriteAsync(Byte[], Int32, Int32, CancellationToken) sebagai gantinya.)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Finalize()	Memastikan bahwa sumber daya dibebaskan dan operasi pembersihan lainnya dilakukan ketika pengumpul sampah mengambil kembali FileStream.
Flush()	Menghapus buffer untuk aliran ini dan menyebabkan data buffer ditulis ke file.
Flush(Boolean)	Menghapus buffer untuk aliran ini dan menyebabkan data buffer ditulis ke file, dan juga menghapus semua buffer file perantara.
FlushAsync()	Secara asinkron menghapus semua buffer untuk aliran ini dan menyebabkan data yang di-buffer ditulis ke perangkat yang mendasar. (Diperoleh dari Stream)
FlushAsync(CancellationToken)	Secara asinkron menghapus semua buffer untuk aliran ini, menyebabkan data yang di-buffer ditulis ke perangkat yang mendasar, dan memantau permintaan pembatalan.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Kedaluwarsa. Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
Lock(Int64, Int64)	Mencegah proses lain membaca dari atau menulis ke FileStream.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek MarshalByRefObject saat ini. (Diperoleh dari MarshalByRefObject)
ObjectInvariant()	Kedaluwarsa. Menyediakan dukungan untuk Contract. (Diperoleh dari Stream)
Read(Byte[], Int32, Int32)	Membaca blok byte dari aliran dan menulis data dalam buffer tertentu.
Read(Span<Byte>)	Membaca urutan byte dari aliran file saat ini dan memajukan posisi dalam aliran file dengan jumlah byte yang dibaca.
ReadAsync(Byte[], Int32, Int32)	Secara asinkron membaca urutan byte dari aliran saat ini dan memajukan posisi dalam aliran dengan jumlah byte yang dibaca. (Diperoleh dari Stream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Secara asinkron membaca urutan byte dari aliran file saat ini dan menulisnya ke array byte yang dimulai pada offset tertentu, memajukan posisi dalam aliran file dengan jumlah byte yang dibaca, dan memantau permintaan pembatalan.
ReadAsync(Memory<Byte>, CancellationToken)	Secara asinkron membaca urutan byte dari aliran file saat ini dan menulisnya ke wilayah memori, memajukan posisi dalam aliran file dengan jumlah byte yang dibaca, dan memantau permintaan pembatalan.
ReadAtLeast(Span<Byte>, Int32, Boolean)	Membaca setidaknya jumlah minimum byte dari aliran saat ini dan memajukan posisi dalam aliran dengan jumlah byte yang dibaca. (Diperoleh dari Stream)
ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken)	Secara asinkron membaca setidaknya jumlah minimum byte dari aliran saat ini, memajukan posisi dalam aliran dengan jumlah byte yang dibaca, dan memantau permintaan pembatalan. (Diperoleh dari Stream)
ReadByte()	Membaca byte dari file dan memajukan posisi baca satu byte.
ReadExactly(Byte[], Int32, Int32)	Membaca count jumlah byte dari aliran saat ini dan memajukan posisi dalam aliran. (Diperoleh dari Stream)
ReadExactly(Span<Byte>)	Membaca byte dari aliran saat ini dan memajukan posisi dalam aliran hingga buffer terisi. (Diperoleh dari Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Membaca secara asinkron count jumlah byte dari aliran saat ini, memajukan posisi dalam aliran, dan memantau permintaan pembatalan. (Diperoleh dari Stream)
ReadExactlyAsync(Memory<Byte>, CancellationToken)	Membaca byte secara asinkron dari aliran saat ini, memajukan posisi dalam aliran hingga buffer terisi, dan memantau permintaan pembatalan. (Diperoleh dari Stream)
Seek(Int64, SeekOrigin)	Mengatur posisi aliran ini saat ini ke nilai yang diberikan.
SetLength(Int64)	Mengatur panjang aliran ini ke nilai yang diberikan.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
Unlock(Int64, Int64)	Memungkinkan akses oleh proses lain ke semua atau sebagian file yang sebelumnya dikunci.
Write(Byte[], Int32, Int32)	Menulis blok byte ke aliran file.
Write(ReadOnlySpan<Byte>)	Menulis urutan byte dari rentang baca-saja ke aliran file saat ini dan memajukan posisi saat ini dalam aliran file ini dengan jumlah byte yang ditulis.
WriteAsync(Byte[], Int32, Int32)	Secara asinkron menulis urutan byte ke aliran saat ini dan memajukan posisi saat ini dalam aliran ini dengan jumlah byte yang ditulis. (Diperoleh dari Stream)
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Secara asinkron menulis urutan byte ke aliran saat ini, memajukan posisi saat ini dalam aliran ini dengan jumlah byte yang ditulis, dan memantau permintaan pembatalan.
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Secara asinkron menulis urutan byte dari wilayah memori ke aliran file saat ini, memajukan posisi saat ini dalam aliran file ini dengan jumlah byte yang ditulis, dan memantau permintaan pembatalan.
WriteByte(Byte)	Menulis byte ke posisi saat ini dalam aliran file.

Metode Ekstensi

GetAccessControl(FileStream)	Mengembalikan informasi keamanan file.
SetAccessControl(FileStream, FileSecurity)	Mengubah atribut keamanan file yang ada.
CopyToAsync(Stream, PipeWriter, CancellationToken)	Secara asinkron membaca byte dari Stream dan menulisnya ke PipeWriteryang ditentukan , menggunakan token pembatalan.
ConfigureAwait(IAsyncDisposable, Boolean)	Mengonfigurasi bagaimana menunggu tugas yang dikembalikan dari asinkron sekali pakai akan dilakukan.

Lihat juga

• File
• FileAccess
• FileMode
• FileShare
• I/O File dan Stream
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File
• Cara: Membaca dan Menulis ke File Data yang Baru Dibuat