Stream Sınıf

Tanım

public ref class Stream abstract : IDisposable

public ref class Stream abstract : MarshalByRefObject, IAsyncDisposable, IDisposable

public ref class Stream abstract : MarshalByRefObject, IDisposable

public abstract class Stream : IDisposable

public abstract class Stream : MarshalByRefObject, IAsyncDisposable, IDisposable

public abstract class Stream : MarshalByRefObject, IDisposable

[System.Serializable]
public abstract class Stream : MarshalByRefObject, IDisposable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Stream : MarshalByRefObject, IDisposable

type Stream = class
    interface IDisposable

type Stream = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable

type Stream = class
    inherit MarshalByRefObject
    interface IDisposable

[<System.Serializable>]
type Stream = class
    inherit MarshalByRefObject
    interface IDisposable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Stream = class
    inherit MarshalByRefObject
    interface IDisposable

Public MustInherit Class Stream
Implements IDisposable

Public MustInherit Class Stream
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable

Public MustInherit Class Stream
Inherits MarshalByRefObject
Implements IDisposable

Devralma

Object

Stream

Devralma

Object

MarshalByRefObject

Stream

Türetilmiş

Microsoft.JScript.COMCharStream

System.Data.OracleClient.OracleBFile

System.Data.OracleClient.OracleLob

System.Data.SqlTypes.SqlFileStream

System.IO.BufferedStream

Diğer…

Öznitelikler

SerializableAttribute ComVisibleAttribute

Uygulamalar

IDisposable IAsyncDisposable

Örnekler

Aşağıdaki örnekte, dosyaları bir dizinden başka bir dizine zaman uyumsuz olarak kopyalamak için iki FileStream nesnesinin nasıl kullanılacağı gösterilmektedir. FileStream sınıfı Stream sınıfından türetilir. Button denetimi için Click olay işleyicisinin zaman uyumsuz bir yöntem çağırdığı için async değiştiricisi ile işaretlendiğini görebilirsiniz.

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

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

        private async void Button_Click(object sender, RoutedEventArgs e)
        {
            string StartDirectory = @"c:\Users\exampleuser\start";
            string EndDirectory = @"c:\Users\exampleuser\end";

            foreach (string filename in Directory.EnumerateFiles(StartDirectory))
            {
                using (FileStream SourceStream = File.Open(filename, FileMode.Open))
                {
                    using (FileStream DestinationStream = File.Create(EndDirectory + filename.Substring(filename.LastIndexOf('\\'))))
                    {
                        await SourceStream.CopyToAsync(DestinationStream);
                    }
                }
            }
        }
    }
}

Imports System.IO

Class MainWindow

    Private Async Sub Button_Click(sender As Object, e As RoutedEventArgs)
        Dim StartDirectory As String = "c:\Users\exampleuser\start"
        Dim EndDirectory As String = "c:\Users\exampleuser\end"

        For Each filename As String In Directory.EnumerateFiles(StartDirectory)
            Using SourceStream As FileStream = File.Open(filename, FileMode.Open)
                Using DestinationStream As FileStream = File.Create(EndDirectory + filename.Substring(filename.LastIndexOf("\"c)))
                    Await SourceStream.CopyToAsync(DestinationStream)
                End Using

            End Using
        Next
    End Sub

End Class

Açıklamalar

Stream tüm akışların soyut temel sınıfıdır. Akış, dosya, giriş/çıkış cihazı, işlemler arası iletişim kanalı veya TCP/IP yuvası gibi bir bayt dizisinin soyutlamasıdır. Stream sınıfı ve türetilmiş sınıfları, bu farklı giriş ve çıkış türlerinin genel bir görünümünü sağlar ve programcıyı işletim sisteminin ve temel cihazların belirli ayrıntılarından yalıtır.

Akışlar üç temel işlem içerir:

• Akışlardan okuyabilirsiniz. Okuma, bir akıştan bayt dizisi gibi bir veri yapısına veri aktarımıdır.

• Akışlara yazabilirsiniz. Yazma, bir veri yapısından bir akışa veri aktarımıdır.

• Akışlar aramayı destekleyebilir. Arama, bir akıştaki geçerli konumu sorgulamayı ve değiştirmeyi ifade eder. Arama özelliği, bir akışın sahip olduğu yedekleme deposunun türüne bağlıdır. Örneğin, ağ akışları geçerli bir konum hakkında birleşik bir kavram içermez ve bu nedenle genellikle aramayı desteklemez.

Stream devralan daha yaygın olarak kullanılan akışlardan bazıları FileStreamve MemoryStream.

Temel alınan veri kaynağına veya depoya bağlı olarak, akışlar bu özelliklerin yalnızca bazılarını destekleyebileceğinden. Stream sınıfının CanRead, CanWriteve CanSeek özelliklerini kullanarak bir akışı özelliklerini sorgulayabilirsiniz.

Read ve Write yöntemleri verileri çeşitli biçimlerde okur ve yazar. Aramayı destekleyen akışlar için Seek ve SetLength yöntemlerini ve Position ve Length özelliklerini kullanarak bir akışın geçerli konumunu ve uzunluğunu sorgulayıp değiştirin.

Bu tür IDisposable arabirimini uygular. Türünü kullanmayı bitirdiğinizde, doğrudan veya dolaylı olarak atmalısınız. Türü doğrudan atmak için Dispose yöntemini bir try/catch bloğunda çağırın. Bunu dolaylı olarak atmak için using (C#'de) veya Using (Visual Basic'te) gibi bir dil yapısı kullanın. Daha fazla bilgi için IDisposable arabirimi konusunun "IDisposable Uygulayan Bir Nesne Kullanma" bölümüne bakın.

bir Stream nesnesinin atılması, arabelleğe alınan tüm verileri temizler ve temelde sizin için Flush yöntemini çağırır. Dispose ayrıca dosya tanıtıcıları, ağ bağlantıları veya herhangi bir iç arabelleğe alma için kullanılan bellek gibi işletim sistemi kaynaklarını da serbest bırakır. BufferedStream sınıfı, okuma ve yazma performansını geliştirmek için arabelleğe alınan bir akışı başka bir akışın çevresinde sarmalama özelliği sağlar.

.NET Framework 4.5'den başlayarak, Stream sınıfı zaman uyumsuz işlemleri basitleştirmek için zaman uyumsuz yöntemler içerir. Zaman uyumsuz yöntem adında ReadAsync, WriteAsync, CopyToAsyncve FlushAsyncgibi Async içerir. Bu yöntemler, ana iş parçacığını engellemeden yoğun kaynak kullanımlı G/Ç işlemleri gerçekleştirmenizi sağlar. Zaman alan bir akış işleminin ui iş parçacığını engelleyebildiği ve uygulamanızın çalışmıyor gibi görünmesini sağlayabildiği bir Windows 8.x Store uygulamasında veya masaüstü uygulamasında bu performansla ilgili dikkat edilmesi gerekenler özellikle önemlidir. Zaman uyumsuz yöntemler, Visual Basic ve C# içindeki async ve await anahtar sözcükleriyle birlikte kullanılır.

Bir Windows 8.x Store uygulamasında kullanıldığında, Stream iki uzantı yöntemi içerir: AsInputStream ve AsOutputStream. Bu yöntemler, Stream nesnesini Windows Çalışma Zamanı'ndaki bir akışa dönüştürür. Ayrıca AsStreamForRead ve AsStreamForWrite yöntemlerini kullanarak Windows Çalışma Zamanı'ndaki bir akışı Stream nesnesine dönüştürebilirsiniz. Daha fazla bilgi için bkz. Nasıl yapılır: .NET Framework Akışları ile Windows Çalışma Zamanı Akışları Arasında Dönüştürme

Bazı akış uygulamaları, performansı geliştirmek için temel alınan verilerin yerel arabelleğe alma işlemini gerçekleştirir. Bu tür akışlarda, iç arabellekleri temizlemek ve tüm verilerin temel alınan veri kaynağına veya depoya yazılmasını sağlamak için Flush veya FlushAsync yöntemini kullanabilirsiniz.

Yedekleme deposu olmayan bir akışa ihtiyacınız varsa (bit demeti olarak da bilinir), bu amaçla tasarlanmış bir akışın örneğini almak için Null alanını kullanın.

Uygulayanlara Notlar

türetilmiş bir Streamsınıfı uyguladığınızda, Read(Byte[], Int32, Int32) ve Write(Byte[], Int32, Int32) yöntemleri için uygulamalar sağlamanız gerekir. ReadAsync(Byte[], Int32, Int32)zaman uyumsuz yöntemler, WriteAsync(Byte[], Int32, Int32)ve CopyToAsync(Stream) uygulamalarında Read(Byte[], Int32, Int32) ve Write(Byte[], Int32, Int32) zaman uyumlu yöntemleri kullanır. Bu nedenle, Read(Byte[], Int32, Int32) ve Write(Byte[], Int32, Int32) uygulamalarınız zaman uyumsuz yöntemlerle doğru şekilde çalışır. varsayılan ReadByte() ve WriteByte(Byte) uygulamaları yeni bir tek öğeli bayt dizisi oluşturur ve ardından Read(Byte[], Int32, Int32) ve Write(Byte[], Int32, Int32)uygulamalarınızı çağırır. Streamtüretdiğinizde, büyük ölçüde daha iyi performans için iç arabelleğinize erişmek için bu yöntemleri geçersiz kılmanızı öneririz. Ayrıca CanRead, CanSeek, CanWrite, Flush(), Length, Position, Seek(Int64, SeekOrigin)ve SetLength(Int64)uygulamalarını sağlamanız gerekir.

bunun yerine Close() yöntemini geçersiz kılmayın, bunun yerine tüm Stream temizleme mantığını Dispose(Boolean) yöntemine yerleştirin. Daha fazla bilgi için bkz. Dispose Yöntemi Uygulama.

Oluşturucular

Alanlar

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Uzantı Metotları

Şunlara uygulanır

Ayrıca bkz.

• FileStream
• MemoryStream
• BufferedStream
• Dosya ve Akış G/Ç
• Nasıl Yapılır: .NET Framework Akışları ile Windows Çalışma Zamanı Akışları Arasında Dönüştürme