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

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 Sockethangi FileAccess iznin NetworkStream olduğunu da belirtebilirsiniz. Varsayılan olarak, öğesinin NetworkStream kapatılması 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.

, NetworkStream ağ 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 NetworkStream 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 sınıfının yeni bir örneğini NetworkStream oluşturur.
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)	Belirtilen erişim haklarıyla belirtilen Socket için sınıfının yeni bir örneğini NetworkStream oluşturur.
NetworkStream(Socket, FileAccess, Boolean)	Belirtilen erişim hakları ve belirtilen sahiplik ile belirtilen Socket için sınıfının yeni bir örneğini NetworkStreamSocket oluşturur.

Özellikler

CanRead	okumayı NetworkStream destekleyip desteklemediğini gösteren bir değer alır.
CanSeek	Akışın aramayı destekleyip desteklemediğini belirten bir değer alır. Bu özellik şu anda desteklenmiyor. Bu özellik her zaman false döndürür.
CanTimeout	Zaman aşımı özelliklerinin için NetworkStreamkullanılabilir olup olmadığını gösterir.
CanWrite	öğesinin 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 verileri beklemesini engelleyebilecek süreyi 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 beklemesini engelleyebilecek süreyi alır veya ayarlar.

Yöntemler

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 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 bir şekilde atıldığından emin olun. (Devralındığı yer: Stream)
Close(Int32)	NetworkStream Verilerin gönderilmesine izin vermek için belirtilen süreyi bekledikten sonra öğesini kapatır.
Close(TimeSpan)	NetworkStream Verilerin gönderilmesine izin vermek için belirtilen süreyi bekledikten sonra öğesini 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 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 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)	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()	Stream tarafı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 yönetilen kaynakları isteğe bağlı olarak 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 yazmanın sonunu işler.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Finalize()	NetworkStream tarafı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()	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)
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)	'den NetworkStream verileri okur ve bir bayt dizisine depolar.
Read(Span<Byte>)	dosyasındaki NetworkStream verileri 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)	'den NetworkStream verileri okur ve zaman uyumsuz bir işlem olarak belirtilen bayt dizisi aralığına depolar.
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 zaman uyumsuz olarak en az sayıda bayt okur, okunan bayt sayısına göre akış içindeki 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 ilerler 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 dizeyi 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 öğesine veri yazar.
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 bir işlem olarak belirtilen bayt dizisi aralığından öğesine veri NetworkStream yazar.
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Salt okunur bellek bayt bellek aralığındaki NetworkStream verileri zaman uyumsuz bir işlem olarak yazar.
WriteByte(Byte)	içindeki NetworkStream geçerli konuma bir bayt yazar ve akışın içindeki konumu bir bayt ilerletir.

Uzantı Metotları

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

• TcpClient