FileStream Sınıf

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

FileStream.cs

Stream Hem zaman uyumlu hem de zaman uyumsuz okuma ve yazma işlemlerini destekleyen bir dosya 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ı bir TextBlock'a ve Button_Click adlı click olay işleyicisine bağlanmış 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 . FileStream için ek API açıklamaları.

Oluşturucular

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

Ö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 belirten 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 belirten bir değer alır.
Handle	Geçersiz. Geçerli FileStream nesnenin kapsüllediğini dosyanın işletim sistemi dosya tanıtıcısını alır.
IsAsync	öğesinin zaman uyumsuz olarak mı yoksa zaman uyumlu olarak mı FileStream açıldığını gösteren bir değer alır.
Length	Akışın bayt cinsinden uzunluğunu alır.
Name	dosyasında 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	SafeFileHandle Geçerli FileStream nesnenin kapsüllediğini dosyanın işletim sistemi dosya tanıtıcısını temsil eden bir 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 kullanmayı ReadAsync(Byte[], Int32, Int32, CancellationToken) göz önünde bulundurun.
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Zaman uyumsuz bir yazma işlemi başlatır. Bunun yerine kullanmayı WriteAsync(Byte[], Int32, Int32, CancellationToken) 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 bir ş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 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 nesne ayırır. (Devralındığı yer: Stream)
Dispose()	Stream tarafı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 yönetilen kaynakları isteğe bağlı olarak serbest bırakır.
DisposeAsync()	tarafından FileStreamkullanılan yönetilmeyen kaynakları zaman uyumsuz olarak serbest bırakır.
EndRead(IAsyncResult)	Bekleyen zaman uyumsuz okuma işleminin tamamlanmasını bekler. (Bunun yerine kullanmayı ReadAsync(Byte[], Int32, Int32, CancellationToken) düşünün.)
EndWrite(IAsyncResult)	Zaman uyumsuz yazma işlemini sonlandırır ve G/Ç işlemi tamamlanana kadar engeller. (Bunun yerine kullanmayı WriteAsync(Byte[], Int32, Int32, CancellationToken) 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 çöp toplayıcı tarafından geri kazanıldığında diğer temizleme işlemlerinin gerçekleştirilmesini FileStreamsağ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()	Type Geçerli örneğini 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'den okumasını veya 'a yazmasını FileStreamengeller.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
ObjectInvariant()	Geçersiz. için Contractdestek 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 ilerletir.
ReadAsync(Byte[], Int32, Int32)	Geçerli akıştaki bayt dizisini zaman uyumsuz olarak 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ışındaki bayt dizisini zaman uyumsuz olarak okur ve bunları belirtilen uzaklıkta başlayan bir bayt dizisine yazar, dosya akışındaki konumu okunan bayt sayısına kadar 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ışı içindeki konumu okunan bayt sayısına kadar ilerler 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ı kadar akış içindeki 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)	count Geçerli akıştan 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 doldurulana kadar buffer akış içindeki konumu ilerler. (Devralındığı yer: Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Geçerli akıştaki bayt sayısını zaman uyumsuz olarak okur count , 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, doldurulana kadar buffer akış içindeki konumu ilerler 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 dizeyi döndürür. (Devralındığı yer: Object)
Unlock(Int64, Int64)	Daha önce kilitlenmiş bir dosyanın tümüne veya bir bölümüne diğer işlemler tarafından erişim izni 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 yazılan bayt sayısına göre bu akıştaki geçerli konumu 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)	Zaman uyumsuz olarak bellek bölgesinden geçerli dosya akışına bir bayt dizisi yazar, bu dosya akışındaki geçerli konumu yazılan bayt sayısına göre ilerler ve iptal isteklerini izler.
WriteByte(Byte)	Dosya akışındaki geçerli konuma bir bayt yazar.

Uzantı Metotları

GetAccessControl(FileStream)	Dosyanın güvenlik bilgilerini döndürür.
SetAccessControl(FileStream, FileSecurity)	Var olan bir dosyanın güvenlik özniteliklerini değiştirir.
ConfigureAwait(IAsyncDisposable, Boolean)	Zaman uyumsuz bir atılabilir öğeden döndürülen görevlerde awaits işleminin nasıl gerçekleştirildiğini yapılandıran.

Ayrıca bkz.

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