FileStream Sınıf

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

FileStream.cs

Hem zaman uyumlu hem de zaman uyumsuz okuma ve yazma işlemlerini destekleyen bir dosya için Stream sağlar.

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

public class FileStream : System.IO.Stream

type FileStream = class
    inherit Stream

Public Class FileStream
Inherits Stream

Devralma

Object

MarshalByRefObject

Stream

FileStream

Türetilmiş

System.IO.IsolatedStorage.IsolatedStorageFileStream

Örnekler

Aşağıdaki örnekte bazı FileStream oluşturucuları gösterilmektedir.

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

Aşağıdaki örnekte, bir dosyaya zaman uyumsuz olarak yazma işlemi gösterilmektedir. Bu kod, UserInput adlı TextBlock'a ve Button_Click adlı click olay işleyicisine bağlı bir düğmeye sahip bir WPF uygulamasında çalışır. Dosya yolunun bilgisayarda bulunan bir dosyayla değiştirilmesi gerekir.

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

Açıklamalar

Bu API hakkında daha fazla bilgi için bkz. FileStreamiçin ek API açıklamaları .

Oluşturucular

FileStream(IntPtr, FileAccess)	Geçersiz. Belirtilen dosya tanıtıcısı için FileStream sınıfının yeni bir örneğini, belirtilen okuma/yazma izniyle başlatır.
FileStream(IntPtr, FileAccess, Boolean)	Geçersiz. Belirtilen dosya tanıtıcısı için, belirtilen okuma/yazma izni ve FileStream örnek sahipliğiyle FileStream sınıfının yeni bir örneğini başlatır.
FileStream(IntPtr, FileAccess, Boolean, Int32)	Geçersiz. Belirtilen dosya tanıtıcısı için, belirtilen okuma/yazma izni, FileStream örnek sahipliği ve arabellek boyutuyla FileStream sınıfının yeni bir örneğini başlatır.
FileStream(IntPtr, FileAccess, Boolean, Int32, Boolean)	Geçersiz. Belirtilen dosya tanıtıcısı için, belirtilen okuma/yazma izni, FileStream örnek sahipliği, arabellek boyutu ve zaman uyumlu veya zaman uyumsuz durum ile FileStream sınıfının yeni bir örneğini başlatır.
FileStream(SafeFileHandle, FileAccess)	Belirtilen dosya tanıtıcısı için FileStream sınıfının yeni bir örneğini, belirtilen okuma/yazma izniyle başlatır.
FileStream(SafeFileHandle, FileAccess, Int32)	Belirtilen dosya tanıtıcısı için, belirtilen okuma/yazma izni ve arabellek boyutuyla FileStream sınıfının yeni bir örneğini başlatır.
FileStream(SafeFileHandle, FileAccess, Int32, Boolean)	Belirtilen dosya tanıtıcısı için, belirtilen okuma/yazma izni, arabellek boyutu ve zaman uyumlu veya zaman uyumsuz durum ile FileStream sınıfının yeni bir örneğini başlatır.
FileStream(String, FileMode)	Belirtilen yol ve oluşturma moduyla FileStream sınıfının yeni bir örneğini başlatır.
FileStream(String, FileMode, FileAccess)	Belirtilen yol, oluşturma modu ve okuma/yazma izniyle FileStream sınıfının yeni bir örneğini başlatır.
FileStream(String, FileMode, FileAccess, FileShare)	Belirtilen yol, oluşturma modu, okuma/yazma izni ve paylaşım izni ile FileStream sınıfının yeni bir örneğini başlatır.
FileStream(String, FileMode, FileAccess, FileShare, Int32)	Belirtilen yol, oluşturma modu, okuma/yazma ve paylaşma izni ve arabellek boyutu ile FileStream sınıfının yeni bir örneğini başlatır.
FileStream(String, FileMode, FileAccess, FileShare, Int32, Boolean)	Belirtilen yol, oluşturma modu, okuma/yazma ve paylaşma izni, arabellek boyutu ve zaman uyumlu veya zaman uyumsuz durum ile FileStream sınıfının yeni bir örneğini başlatır.
FileStream(String, FileMode, FileAccess, FileShare, Int32, FileOptions)	FileStream sınıfının yeni bir örneğini belirtilen yol, oluşturma modu, okuma/yazma ve paylaşma izniyle başlatır; diğer FileStreams erişimi aynı dosyaya, arabellek boyutuna ve ek dosya seçeneklerine sahip olabilir.
FileStream(String, FileStreamOptions)	FileStream sınıfının yeni bir örneğini belirtilen yol, oluşturma modu, okuma/yazma ve paylaşma izni, arabellek boyutu, ek dosya seçenekleri, ön yükleme boyutu ve diğer FileStreams'in aynı dosyaya erişimi ile başlatır.

Özellikler

CanRead	Geçerli akışın okumayı destekleyip desteklemediğini gösteren bir değer alır.
CanSeek	Geçerli akışın aramayı destekleyip desteklemediğini gösteren bir değer alır.
CanTimeout	Geçerli akışın zaman aşımına neden olup olmadığını belirleyen bir değer alır. (Devralındığı yer: Stream)
CanWrite	Geçerli akışın yazmayı destekleyip desteklemediğini gösteren bir değer alır.
Handle	Geçersiz. Geçerli FileStream nesnesinin kapsüllediğini dosyanın işletim sistemi dosya tutamacını alır.
IsAsync	FileStream zaman uyumsuz olarak mı yoksa zaman uyumlu olarak mı açıldığını gösteren bir değer alır.
Length	Akışın bayt cinsinden uzunluğunu alır.
Name	FileStreamaçılan dosyanın mutlak yolunu alır.
Position	Bu akışın geçerli konumunu alır veya ayarlar.
ReadTimeout	Akışın zaman aşımına uğramadan önce ne kadar süreyle okumayı deneyeceğini belirleyen bir değeri milisaniye cinsinden alır veya ayarlar. (Devralındığı yer: Stream)
SafeFileHandle	Geçerli FileStream nesnesinin kapsüllediğini dosyanın işletim sistemi dosya tanıtıcısını temsil eden bir SafeFileHandle nesnesi alır.
WriteTimeout	Akışın zaman aşımına uğramadan önce ne kadar süreyle yazmaya çalışacağını belirleyen bir değeri milisaniye cinsinden alır veya ayarlar. (Devralındığı yer: Stream)

Yöntemler

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	Zaman uyumsuz bir okuma işlemi başlatır. Bunun yerine ReadAsync(Byte[], Int32, Int32, CancellationToken) kullanmayı göz önünde bulundurun.
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Zaman uyumsuz bir yazma işlemi başlatır. Bunun yerine WriteAsync(Byte[], Int32, Int32, CancellationToken) kullanmayı göz önünde bulundurun.
Close()	Geçerli akışı kapatır ve geçerli akışla ilişkili tüm kaynakları (yuvalar ve dosya tanıtıcıları gibi) serbest bırakır. Bu yöntemi çağırmak yerine akışın düzgün şekilde atıldığından emin olun. (Devralındığı yer: Stream)
CopyTo(Stream)	Geçerli akıştan baytları okur ve başka bir akışa yazar. Her iki akış konumu da kopyalanan bayt sayısına göre gelişmiştir. (Devralındığı yer: Stream)
CopyTo(Stream, Int32)	Geçerli akıştan baytları okur ve belirtilen arabellek boyutunu kullanarak başka bir akışa yazar. Her iki akış konumu da kopyalanan bayt sayısına göre gelişmiştir. (Devralındığı yer: Stream)
CopyToAsync(Stream)	Geçerli akıştan gelen baytları zaman uyumsuz olarak okur ve başka bir akışa yazar. Her iki akış konumu da kopyalanan bayt sayısına göre gelişmiştir. (Devralındığı yer: Stream)
CopyToAsync(Stream, CancellationToken)	Geçerli akıştan gelen baytları zaman uyumsuz olarak okur ve belirtilen iptal belirtecini kullanarak başka bir akışa yazar. Her iki akış konumu da kopyalanan bayt sayısına göre gelişmiştir. (Devralındığı yer: Stream)
CopyToAsync(Stream, Int32)	Geçerli akıştan gelen baytları zaman uyumsuz olarak okur ve belirtilen arabellek boyutunu kullanarak başka bir akışa yazar. Her iki akış konumu da kopyalanan bayt sayısına göre gelişmiştir. (Devralındığı yer: Stream)
CopyToAsync(Stream, Int32, CancellationToken)	Geçerli dosya akışındaki baytları zaman uyumsuz olarak okur ve belirtilen arabellek boyutu ve iptal belirtecini kullanarak başka bir akışa yazar.
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
CreateWaitHandle()	Geçersiz. bir WaitHandle nesnesi ayırır. (Devralındığı yer: Stream)
Dispose()	Streamtarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Stream)
Dispose(Boolean)	FileStream tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
DisposeAsync()	FileStreamtarafından kullanılan yönetilmeyen kaynakları zaman uyumsuz olarak serbest bırakır.
EndRead(IAsyncResult)	Bekleyen zaman uyumsuz okuma işleminin tamamlanmasını bekler. (Bunun yerine ReadAsync(Byte[], Int32, Int32, CancellationToken) kullanmayı düşünün.)
EndWrite(IAsyncResult)	Zaman uyumsuz yazma işlemini sonlandırır ve G/Ç işlemi tamamlanana kadar engeller. (Bunun yerine WriteAsync(Byte[], Int32, Int32, CancellationToken) kullanmayı düşünün.)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Finalize()	Kaynakların serbest kalmasını ve atık toplayıcı FileStreamgeri kazandığında diğer temizleme işlemlerinin gerçekleştirilmesini sağlar.
Flush()	Bu akış için arabellekleri temizler ve arabelleğe alınan verilerin dosyaya yazılmasına neden olur.
Flush(Boolean)	Bu akış için arabellekleri temizler ve arabelleğe alınan verilerin dosyaya yazılmasına neden olur ve ayrıca tüm ara dosya arabelleklerini temizler.
FlushAsync()	Bu akış için tüm arabellekleri zaman uyumsuz olarak temizler ve arabelleğe alınan verilerin temel alınan cihaza yazılmasına neden olur. (Devralındığı yer: Stream)
FlushAsync(CancellationToken)	Bu akış için tüm arabellekleri zaman uyumsuz olarak temizler, arabelleğe alınan verilerin temel alınan cihaza yazılmasına neden olur ve iptal isteklerini izler.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
Lock(Int64, Int64)	diğer işlemlerin FileStream'den okumasını veya yazmasını engeller.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnesinin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
ObjectInvariant()	Geçersiz. Contractiçin destek sağlar. (Devralındığı yer: Stream)
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.
ReadAsync(Byte[], Int32, Int32)	Geçerli akıştan zaman uyumsuz olarak bir bayt dizisi okur ve okunan bayt sayısına göre akış içindeki konumu ilerletir. (Devralındığı yer: Stream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Geçerli dosya akışından zaman uyumsuz olarak bir bayt dizisi okur ve bunları belirtilen uzaklıkta başlayan bir bayt dizisine yazar, dosya akışındaki konumu okunan bayt sayısına göre ilerler ve iptal isteklerini izler.
ReadAsync(Memory<Byte>, CancellationToken)	Geçerli dosya akışından zaman uyumsuz olarak bir bayt dizisi okur ve bunları bir bellek bölgesine yazar, dosya akışındaki konumu okunan bayt sayısına göre ilerletir ve iptal isteklerini izler.
ReadAtLeast(Span<Byte>, Int32, Boolean)	Geçerli akıştan en az bayt sayısını okur ve okunan bayt sayısına göre akış içindeki konumu ilerletir. (Devralındığı yer: Stream)
ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken)	Geçerli akıştan en az en az sayıda bayt zaman uyumsuz olarak okur, okunan bayt sayısına göre akıştaki konumu ilerletir ve iptal isteklerini izler. (Devralındığı yer: Stream)
ReadByte()	Dosyadan bir bayt okur ve okuma konumunu bir bayt ilerletir.
ReadExactly(Byte[], Int32, Int32)	Geçerli akıştan count bayt sayısını okur ve akış içindeki konumu ilerletir. (Devralındığı yer: Stream)
ReadExactly(Span<Byte>)	Geçerli akıştan baytları okur ve buffer doldurulana kadar akıştaki konumu ilerletir. (Devralındığı yer: Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Geçerli akıştan count bayt sayısını zaman uyumsuz olarak okur, akış içindeki konumu ilerletir ve iptal isteklerini izler. (Devralındığı yer: Stream)
ReadExactlyAsync(Memory<Byte>, CancellationToken)	Geçerli akıştaki baytları zaman uyumsuz olarak okur, buffer doldurulana kadar akıştaki konumu ilerletir ve iptal isteklerini izler. (Devralındığı yer: Stream)
Seek(Int64, SeekOrigin)	Bu akışın geçerli konumunu verilen değere ayarlar.
SetLength(Int64)	Bu akışın uzunluğunu verilen değere ayarlar.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)
Unlock(Int64, Int64)	Daha önce kilitli olan bir dosyanın tümüne veya bir bölümüne diğer işlemlerin erişmesine izin verir.
Write(Byte[], Int32, Int32)	Dosya akışına bir bayt bloğu yazar.
Write(ReadOnlySpan<Byte>)	Salt okunur bir aralıktan geçerli dosya akışına bir bayt dizisi yazar ve bu dosya akışındaki geçerli konumu yazılan bayt sayısı kadar ilerletir.
WriteAsync(Byte[], Int32, Int32)	Zaman uyumsuz olarak geçerli akışa bir bayt dizisi yazar ve bu akıştaki geçerli konumu yazılan bayt sayısına göre ilerletir. (Devralındığı yer: Stream)
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Zaman uyumsuz olarak geçerli akışa bir bayt dizisi yazar, bu akıştaki geçerli konumu yazılan bayt sayısına göre ilerletir ve iptal isteklerini izler.
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Bellek bölgesinden geçerli dosya akışına zaman uyumsuz olarak bir bayt dizisi yazar, bu dosya akışındaki geçerli konumu yazılan bayt sayısına göre ilerletir ve iptal isteklerini izler.
WriteByte(Byte)	Dosya akışındaki geçerli konuma bir bayt yazar.

Uzantı Metotları

GetAccessControl(FileStream)	Bir dosyanın güvenlik bilgilerini döndürür.
SetAccessControl(FileStream, FileSecurity)	Var olan bir dosyanın güvenlik özniteliklerini değiştirir.
CopyToAsync(Stream, PipeWriter, CancellationToken)	Stream baytları zaman uyumsuz olarak okur ve bir iptal belirteci kullanarak belirtilen PipeWriteryazar.
ConfigureAwait(IAsyncDisposable, Boolean)	Zaman uyumsuz bir atılabilir öğeden döndürülen görevlerde awaits işleminin nasıl gerçekleştirileceğini yapılandırılır.

Ayrıca bkz.

• File
• FileAccess
• FileMode
• FileShare
• Dosya ve Akış G/Ç
• Nasıl yapılır: Dosya Metin Okuma
• Nasıl yapılır: Dosya Metin Yazma
• Nasıl yapılır: Yeni Oluşturulan Veri Dosyası Okuma ve Yazma