NetworkStream Sınıf

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kodlar:

netstandard.dll, 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

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

oluşturmak NetworkStreamiçin bağlı Socketbir sağlamanız gerekir. Sağlanan üzerinde hangi FileAccess iznin NetworkStreamSocketolduğunu da belirtebilirsiniz. Varsayılan olarak, öğesini NetworkStream kapatmak sağlanan Socketöğesini kapatmaz. öğesinin NetworkStream sağlanan Socketöğesini kapatma iznine sahip olmasını istiyorsanız parametresinin ownsSocket değerini belirtmeniz true gerekir.

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

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

Okuma ve yazma işlemleri eşitlemeye gerek kalmadan sınıfın bir örneğinde NetworkStream 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

Name	Description
NetworkStream(Socket, Boolean)	Belirtilen Socket sahiplikle belirtilen Socket için sınıfının yeni bir örneğini NetworkStream başlatır.
NetworkStream(Socket, FileAccess, Boolean)	Belirtilen erişim hakları ve Socket belirtilen sahiplik ile belirtilen Socket için sınıfının yeni bir örneğini NetworkStream oluşturur.
NetworkStream(Socket, FileAccess)	Belirtilen erişim haklarıyla belirtilen Socket için sınıfının yeni bir örneğini NetworkStream oluşturur.
NetworkStream(Socket)	Belirtilen Socketiçin sınıfının yeni bir örneğini NetworkStream oluşturur.

Özellikler

Name	Description
CanRead	değerinin okumayı destekleyip desteklemediğini NetworkStream belirten 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 döndürür false.
CanTimeout	Zaman aşımı özelliklerinin için NetworkStreamkullanılabilir olup olmadığını gösterir.
CanWrite	değerinin yazmayı destekleyip desteklemediğini NetworkStream belirten bir değer alır.
DataAvailable	üzerinde verilerin hemen okunacak şekilde kullanılabilir NetworkStream 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	öğesinin okunup NetworkStream 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ınan öğesini alır.
Writeable	yazılabilir olup olmadığını NetworkStream gösteren bir değer alır.
WriteTimeout	Yazma işleminin verileri bekleme süresini alır veya ayarlar.

Yöntemler

Name	Description
BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	'den zaman uyumsuz bir okuma başlatır NetworkStream.
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)	NetworkStream Verilerin gönderilmesine izin vermek için belirtilen süre bekledikten sonra öğesini kapatır.
Close(TimeSpan)	NetworkStream Verilerin gönderilmesine izin vermek için belirtilen süre bekledikten sonra öğesini kapatır.
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)
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)
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, 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)
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)	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)
CreateWaitHandle()	Geçersiz. Bir WaitHandle nesne ayırır. (Devralındığı yer: Stream)
Dispose()	tarafından Streamkullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Stream)
Dispose(Boolean)	tarafından NetworkStream kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
DisposeAsync()	tarafından Streamkullanı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()	tarafından NetworkStreamkullanı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 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)	'den NetworkStream verileri okur ve bir bayt dizisine depolar.
Read(Span<Byte>)	içindeki NetworkStream verileri okur ve bellekteki bir bayt aralığına depolar.
ReadAsync(Byte[], Int32, Int32, CancellationToken)	'den NetworkStream verileri okur ve zaman uyumsuz bir işlem olarak belirtilen bayt dizisi 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(Memory<Byte>, CancellationToken)	içindeki 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()	konumundan 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)	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 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 öğesine veri NetworkStream yazar.
Write(ReadOnlySpan<Byte>)	Salt okunur bayt aralığından NetworkStream 'a veri yazar.
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Belirtilen bayt dizisi aralığındaki verileri NetworkStream zaman uyumsuz bir işlem olarak 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(ReadOnlyMemory<Byte>, CancellationToken)	Salt okunur bellek bayt bellek aralığındaki verileri NetworkStream zaman uyumsuz bir işlem olarak yazar.
WriteByte(Byte)	içindeki NetworkStream geçerli konuma bir bayt yazar ve akıştaki konumu bir bayt ilerletir.

Uzantı Metotları

Name	Description
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.
CopyToAsync(Stream, PipeWriter, CancellationToken)	baytlarını Stream zaman uyumsuz olarak okur ve bir iptal belirteci kullanarak belirtilen PipeWriteröğesine yazar.

Ayrıca bkz.

• TcpClient