NetworkStream Sınıf

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kod:

System.Net.Sockets.dll

Bütünleştirilmiş Kod:

System.dll

Bütünleştirilmiş Kod:

netstandard.dll

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

Object

Stream

NetworkStream

Devralma

Object

MarshalByRefObject

Stream

NetworkStream

Uygulamalar

IDisposable

Örnekler

Aşağıdaki kod örneği, bağlı StreamSocket bir NetworkStream kaynaktan oluşturma ve temel zaman uyumlu engelleme G/Ç işlemlerinin nasıl gerçekleştirildiğini gösterir.

// Examples for constructors that do not specify file permission.
// Create the NetworkStream for communicating with the remote host.
NetworkStream^ myNetworkStream;

if ( networkStreamOwnsSocket )
{
   myNetworkStream = gcnew NetworkStream( mySocket,true );
}
else
{
   myNetworkStream = gcnew NetworkStream( mySocket );
}

// Examples for constructors that do not specify file permission.

// Create the NetworkStream for communicating with the remote host.
NetworkStream myNetworkStream;

if (networkStreamOwnsSocket){
     myNetworkStream = new NetworkStream(mySocket, true);
}
else{
     myNetworkStream = new NetworkStream(mySocket);
}

' Examples for constructors that do not specify file permission.
' Create the NetworkStream for communicating with the remote host.
Dim myNetworkStream As NetworkStream

If networkStreamOwnsSocket Then
   myNetworkStream = New NetworkStream(mySocket, True)
Else
   myNetworkStream = New NetworkStream(mySocket)
End If

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 kaldırma Sockethakkında daha 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ığı zaman uyumlu engelleme G/Ç için ve Read yöntemlerini kullanın. G/Ç'nizi ayrı iş parçacıkları kullanarak işlemek istiyorsanız ve EndWrite yöntemlerini veya BeginRead iletişim için ve EndRead yöntemlerini kullanmayı BeginWrite 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

NetworkStream(Socket)	Belirtilen Socketiçin sınıfının yeni bir örneğini NetworkStream oluşturur.
NetworkStream(Socket, Boolean)	Belirtilen Socket sahiplik ile 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 NetworkStream Socket oluşturur.

Özellikler

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 false döndürür.
CanTimeout	zaman aşımı özelliklerinin için NetworkStreamkullanı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	yazmanın desteklenip desteklemeyeceğini NetworkStream belirten bir değer alır.
DataAvailable	Okunacak verilerde 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	öğ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.
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ı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.
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)	'den zaman uyumsuz bir okuma başlatır NetworkStream.
BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	Zaman uyumsuz bir okuma işlemi başlatır. (Bunun yerine kullanmayı ReadAsync(Byte[], Int32, Int32) göz önünde bulundurun.) (Devralındığı yer: Stream)
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Akışa zaman uyumsuz yazma işlemi başlatır.
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Zaman uyumsuz bir yazma işlemi başlatır. (Bunun yerine kullanmayı WriteAsync(Byte[], Int32, Int32) göz önünde bulundurun.) (Devralındığı yer: Stream)
Close()	öğesini 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 bir şekilde atıldığından emin olun. (Devralındığı yer: Stream)
Close(Int32)	Verilerin gönderilmesine NetworkStream izin vermek için belirtilen süreyi bekledikten sonra öğesini kapatır.
Close(TimeSpan)
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()	Kullanımdan kalktı. Kullanımdan kalktı. Kullanımdan kalktı. 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.
EndRead(IAsyncResult)	Bekleyen zaman uyumsuz okumanın tamamlanmasını bekler. (Bunun yerine kullanmayı ReadAsync(Byte[], Int32, Int32) göz önünde bulundurun.) (Devralındığı yer: Stream)
EndWrite(IAsyncResult)	Zaman uyumsuz yazmanın sonunu işler.
EndWrite(IAsyncResult)	Zaman uyumsuz yazma işlemini sonlandırır. (Bunun yerine kullanmayı WriteAsync(Byte[], Int32, Int32) 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()	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.
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()	Kullanımdan kalktı. 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()	Kullanımdan kalktı. 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()	Kullanımdan kalktı. 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.
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ı kadar 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)	'den NetworkStream verileri 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)	içindeki 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 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.
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)	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.
Write(ReadOnlySpan<Byte>)	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli akışa bir bayt dizisi yazar ve bu akıştaki geçerli konumu yazılan bayt sayısı kadar 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)	Zaman uyumsuz bir işlem olarak belirtilen bayt dizisi aralığından öğesine veri 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)	Salt okunur bellek bayt bellek aralığındaki NetworkStream verileri 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)	içindeki NetworkStream geçerli konuma bir bayt yazar ve akışın içindeki 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. NetworkStream tarafından kullanılan tüm kaynakları serbest bırakır.

Uzantı Metotları

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ırıyor.

Ayrıca bkz.

• TcpClient