NetworkStream Sınıf

Tanım

Ağ erişimi için temel alınan veri akışını sağlar.

public ref class NetworkStream : System::IO::Stream
public class NetworkStream : System.IO.Stream
type NetworkStream = class
    inherit Stream
type NetworkStream = class
    inherit Stream
    interface IDisposable
Public Class NetworkStream
Inherits Stream
Devralma
NetworkStream
Devralma
Uygulamalar

Açıklamalar

NetworkStream sınıfı, engelleme modunda Stream yuvalar üzerinden veri göndermeye ve almaya yönelik yöntemler sağlar. Engelleme ve engellenmemiş Sockethakkında daha fazla bilgi için bkz. Zaman Uyumsuz İstemci Yuvası kullanma. hem zaman uyumlu hem de zaman uyumsuz veri aktarımı için NetworkStream sınıfını kullanabilirsiniz. Zaman uyumlu ve zaman uyumsuz iletişim hakkında daha fazla bilgi için bkz. Yuvalar.

NetworkStreamoluşturmak için bağlı bir Socketsağlamanız gerekir. Ayrıca, sağlanan Socketüzerinde NetworkStream hangi FileAccess iznine sahip olduğunu belirtebilirsiniz. Varsayılan olarak, NetworkStream kapatılarak sağlanan Socketkapatılmaz. NetworkStream sağlanan Socketkapatma iznine sahip olmasını istiyorsanız, ownsSocket parametresinin değeri için true belirtmeniz gerekir.

Basit tek iş parçacıklı zaman uyumlu engelleme G/Ç için Write ve Read yöntemlerini kullanın. G/Ç'nizi zaman uyumsuz olarak işlemek istiyorsanız, ReadAsync ve WriteAsyncTask veya ValueTasktabanlı yöntemleri kullanmayı göz önünde bulundurun.

NetworkStream ağ veri akışına rastgele erişimi desteklemez. Akışın aramayı destekleyip desteklemediğini gösteren CanSeek özelliğinin değeri her zaman false; Position özelliğini okumak, Length özelliğini okumak veya Seek yöntemini çağırmak bir NotSupportedExceptionoluşturur.

Okuma ve yazma işlemleri eşitlemeye gerek kalmadan NetworkStream sınıfının bir örneğinde aynı anda gerçekleştirilebilir. Yazma işlemleri için benzersiz bir iş parçacığı ve okuma işlemleri için benzersiz bir iş parçacığı olduğu sürece, okuma ve yazma iş parçacıkları arasında çapraz girişim olmaz ve eşitleme gerekmez.

Oluşturucular

NetworkStream(Socket)

Belirtilen Socketiçin NetworkStream sınıfının yeni bir örneğini oluşturur.

NetworkStream(Socket, Boolean)

Belirtilen Socket sahip olduğu belirtilen Socket için NetworkStream sınıfının yeni bir örneğini başlatır.

NetworkStream(Socket, FileAccess)

Belirtilen erişim haklarına sahip belirtilen Socket için NetworkStream sınıfının yeni bir örneğini oluşturur.

NetworkStream(Socket, FileAccess, Boolean)

Belirtilen erişim haklarına ve belirtilen Socket sahipliğine sahip belirtilen Socket için NetworkStream sınıfının yeni bir örneğini oluşturur.

Özellikler

CanRead

NetworkStream okumayı destekleyip desteklemediğini gösteren bir değer alır.

CanSeek

Akışın aramayı destekleyip desteklemediğini gösteren bir değer alır. Bu özellik şu anda desteklenmiyor. Bu özellik her zaman falsedöndürür.

CanTimeout

zaman aşımı özelliklerinin NetworkStreamiçin kullanılabilir olup olmadığını gösterir.

CanTimeout

Geçerli akışın zaman aşımına neden olup olmadığını belirleyen bir değer alır.

(Devralındığı yer: Stream)
CanWrite

NetworkStream yazmayı destekleyip desteklemediğini gösteren bir değer alır.

DataAvailable

Verilerin hemen okunacak NetworkStream kullanılabilir olup olmadığını gösteren bir değer alır.

Length

Akışta bulunan verilerin uzunluğunu alır. Bu özellik şu anda desteklenmiyor ve her zaman bir NotSupportedExceptionoluşturur.

Position

Akıştaki geçerli konumu alır veya ayarlar. Bu özellik şu anda desteklenmiyor ve her zaman bir NotSupportedExceptionoluşturur.

Readable

NetworkStream okunup okunamayacağını belirten bir değer alır veya ayarlar.

ReadTimeout

Okuma işleminin veri bekleme süresini 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)
Socket

temel Socketalır.

Writeable

NetworkStream yazılabilir olup olmadığını gösteren bir değer alır.

WriteTimeout

Yazma işleminin verileri bekleme süresini alır veya ayarlar.

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)

NetworkStreamzaman uyumsuz bir okuma başlatır.

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)

Zaman uyumsuz bir okuma işlemi başlatır. (Bunun yerine ReadAsync(Byte[], Int32, Int32) kullanmayı düşünün.)

(Devralındığı yer: Stream)
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)

Akışa zaman uyumsuz bir yazma işlemi başlatır.

BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)

Zaman uyumsuz bir yazma işlemi başlatır. (Bunun yerine WriteAsync(Byte[], Int32, Int32) kullanmayı düşünün.)

(Devralındığı yer: Stream)
Close()

NetworkStreamkapatır.

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)
Close(Int32)

Verilerin gönderilmesine izin vermek için belirtilen süre bekledikten sonra NetworkStream kapatır.

Close(TimeSpan)

Verilerin gönderilmesine izin vermek için belirtilen süre bekledikten sonra NetworkStream kapatır.

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)

Belirtilen arabellek boyutu ve iptal belirtecini kullanarak geçerli akıştan 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)
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.
Geçersiz.
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)

NetworkStream 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()

Streamtarafından kullanılan yönetilmeyen kaynakları zaman uyumsuz olarak serbest bırakır.

(Devralındığı yer: Stream)
EndRead(IAsyncResult)

Zaman uyumsuz okumanın sonunu işler.

EndRead(IAsyncResult)

Bekleyen zaman uyumsuz okumanın tamamlanmasını bekler. (Bunun yerine ReadAsync(Byte[], Int32, Int32) kullanmayı düşünün.)

(Devralındığı yer: Stream)
EndWrite(IAsyncResult)

Zaman uyumsuz yazma işleminin sonunu işler.

EndWrite(IAsyncResult)

Zaman uyumsuz yazma işlemini sonlandırır. (Bunun yerine WriteAsync(Byte[], Int32, Int32) kullanmayı düşünün.)

(Devralındığı yer: Stream)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
Finalize()

NetworkStreamtarafından kullanılan tüm kaynakları serbest bırakır.

Flush()

Akıştan verileri temizler. Bu yöntem gelecekte kullanılmak üzere ayrılmıştır.

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)

Zaman uyumsuz bir işlem olarak akıştan verileri temizler.

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.

(Devralındığı yer: Stream)
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)
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)

verileri NetworkStream okur ve bir bayt dizisine depolar.

Read(Span<Byte>)

verileri NetworkStream okur ve bellekteki bir bayt aralığına depolar.

Read(Span<Byte>)

Türetilmiş bir sınıfta geçersiz kılındığında, geçerli akıştan 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)

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)

verileri NetworkStream okur ve zaman uyumsuz bir işlem olarak belirtilen bayt dizisi aralığına depolar.

ReadAsync(Byte[], Int32, Int32, CancellationToken)

Geçerli akıştan zaman uyumsuz olarak bir bayt dizisi okur, okunan bayt sayısına göre akış içindeki konumu ilerletir ve iptal isteklerini izler.

(Devralındığı yer: Stream)
ReadAsync(Memory<Byte>, CancellationToken)

NetworkStream verileri okur ve zaman uyumsuz bir işlem olarak bayt bellek aralığında depolar.

ReadAsync(Memory<Byte>, CancellationToken)

Geçerli akıştan zaman uyumsuz olarak bir bayt dizisi okur, okunan bayt sayısına göre akış içindeki konumu ilerletir ve iptal isteklerini izler.

(Devralındığı yer: Stream)
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()

NetworkStream bir bayt okur ve akışın içindeki konumu bir bayt ilerletir veya akışın sonundaysa -1 döndürür.

ReadByte()

Akıştan bir bayt okur ve akışın içindeki konumu bir bayt ilerletir veya akışın sonundaysa -1 döndürür.

(Devralındığı yer: Stream)
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)

Akışın geçerli konumunu verilen değere ayarlar. Bu yöntem şu anda desteklenmiyor ve her zaman bir NotSupportedExceptionoluşturur.

SetLength(Int64)

Akışın uzunluğunu ayarlar. Bu yöntem her zaman bir NotSupportedExceptionoluşturur.

ToString()

Geçerli nesneyi temsil eden bir dize döndürür.

(Devralındığı yer: Object)
Write(Byte[], Int32, Int32)

Belirtilen bayt dizisi aralığından NetworkStream veri yazar.

Write(ReadOnlySpan<Byte>)

Verileri salt okunur bayt aralığından NetworkStream yazar.

Write(ReadOnlySpan<Byte>)

Türetilmiş bir sınıfta geçersiz kılındığında, geçerli akışa bir bayt dizisi yazar ve yazılan bayt sayısıyla bu akıştaki geçerli konumu ilerletir.

(Devralındığı yer: Stream)
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)

Belirtilen bayt dizisi aralığındaki verileri zaman uyumsuz bir işlem olarak NetworkStream yazar.

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.

(Devralındığı yer: Stream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Verileri salt okunur bellek bayt bellek aralığından NetworkStream zaman uyumsuz bir işlem olarak yazar.

WriteAsync(ReadOnlyMemory<Byte>, 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.

(Devralındığı yer: Stream)
WriteByte(Byte)

NetworkStream geçerli konumuna bir bayt yazar ve akıştaki konumu bir bayt ilerletir.

WriteByte(Byte)

Akıştaki geçerli konuma bir bayt yazar ve akış içindeki konumu bir bayt ilerletir.

(Devralındığı yer: Stream)

Belirtik Arabirim Kullanımları

IDisposable.Dispose()

Bu API, ürün altyapısını destekler ve doğrudan kodunuzdan kullanıma yönelik değildir.

NetworkStreamtarafından kullanılan tüm kaynakları serbest bırakır.

Uzantı Metotları

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.

Şunlara uygulanır

Ayrıca bkz.