NetworkStream Sınıf

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kod:

System.Net.Sockets.dll

Kaynak:

NetworkStream.cs

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

Public Class NetworkStream
Inherits Stream

Devralma

Object

MarshalByRefObject

Stream

NetworkStream

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.
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.
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.

Yöntemler

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	NetworkStreamzaman uyumsuz bir okuma başlatır.
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Akışa zaman uyumsuz bir yazma işlemi başlatı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. 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.
EndWrite(IAsyncResult)	Zaman uyumsuz yazma işleminin sonunu işler.
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.
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.
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(Memory<Byte>, CancellationToken)	NetworkStream verileri okur ve zaman uyumsuz bir işlem olarak bayt bellek aralığında depolar.
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.
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.
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(ReadOnlyMemory<Byte>, CancellationToken)	Verileri salt okunur bellek bayt bellek aralığından NetworkStream zaman uyumsuz bir işlem olarak yazar.
WriteByte(Byte)	NetworkStream geçerli konumuna bir bayt yazar ve akıştaki konumu bir bayt ilerletir.

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.

Ayrıca bkz.

• TcpClient