Socket.BeginReceive Yöntem

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kod:

System.Net.Sockets.dll

Bağlı Socketbir 'den zaman uyumsuz olarak veri almaya başlar.

Aşırı Yüklemeler

BeginReceive(Byte[], Int32, Int32, SocketFlags, SocketError, AsyncCallback, Object)	Bağlı Socketbir 'den zaman uyumsuz olarak veri almaya başlar.
BeginReceive(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)	Bağlı Socketbir 'den zaman uyumsuz olarak veri almaya başlar.
BeginReceive(IList<ArraySegment<Byte>>, SocketFlags, AsyncCallback, Object)	Bağlı Socketbir 'den zaman uyumsuz olarak veri almaya başlar.
BeginReceive(IList<ArraySegment<Byte>>, SocketFlags, SocketError, AsyncCallback, Object)	Bağlı Socketbir 'den zaman uyumsuz olarak veri almaya başlar.

BeginReceive(Byte[], Int32, Int32, SocketFlags, SocketError, AsyncCallback, Object)

Kaynak:

Socket.cs

Bağlı Socketbir 'den zaman uyumsuz olarak veri almaya başlar.

public:
 IAsyncResult ^ BeginReceive(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult? BeginReceive (byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode, AsyncCallback? callback, object? state);

member this.BeginReceive : byte[] * int * int * System.Net.Sockets.SocketFlags * SocketError * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceive (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, ByRef errorCode As SocketError, callback As AsyncCallback, state As Object) As IAsyncResult

Parametreler

buffer

Byte[]

Alınan verilerin depolama konumu olan tür Byte dizisi.

offset

Int32

Alınan verileri depolamak buffer için konumu.

size

Int32

Alınacak bayt sayısı.

socketFlags

SocketFlags

Değerlerin bit düzeyinde birleşimi SocketFlags .

errorCode

SocketError

SocketError Yuva hatasını depolayan bir nesne.

callback

AsyncCallback

AsyncCallback İşlem tamamlandığında çağırma yöntemine başvuran bir temsilci.

state

Object

Alma işlemi hakkında bilgi içeren kullanıcı tanımlı bir nesne. İşlem tamamlandığında bu nesne temsilciye EndReceive(IAsyncResult) geçirilir.

Döndürülenler

IAsyncResult

IAsyncResult Zaman uyumsuz okumaya başvuran bir.

Özel durumlar

ArgumentNullException

buffer, null değeridir.

SocketException

Yalnızca .NET Framework ve .NET 5 ve öncesi: Yuvaya erişmeye çalışılırken bir hata oluştu.

ObjectDisposedException

Socket kapatıldı.

ArgumentOutOfRangeException

offset 0'dan küçüktür.

-veya-

offset uzunluğundan bufferbüyük.

-veya-

size 0'dan küçüktür.

-veya-

size parametresinin değerinden bufferoffset daha uzundur.

Açıklamalar

Önemli

Bu bir uyumluluk API'sidir. Yeni geliştirme için APM (Begin* ve End*) yöntemlerini kullanmanızı önermiyoruz. Bunun yerine tabanlı eşdeğerleri kullanın Task.

İşlemin AsyncCallbackBeginReceive tamamlanması hakkında bildirim almak için uygulamasına uygulanan bir geri çağırma geçirebilirsiniz. Temel alınan ağ yığını işlemi zaman uyumlu bir şekilde tamamlarsa, çağrısı sırasında geri çağırmanın BeginReceivesatır içinde yürütüleceğini unutmayın. Bu durumda, döndürülen IAsyncResult üzerindeki özelliği yöntemin CompletedSynchronously zaman uyumlu olarak tamamlandığını belirtmek için olarak ayarlanırtrue. yöntemine AsyncState geçirilen durum nesnesini almak için BeginReceive özelliğini IAsyncResult kullanın.

Zaman uyumsuz BeginReceive işlem yöntemi çağrılarak EndReceive tamamlanmalıdır. Genellikle, yöntemi temsilci tarafından çağrılır AsyncCallback . EndReceive işlem tamamlanana kadar çağıran iş parçacığını engeller.

Bekleyen BeginReceivebir öğesini iptal etmek için öğesini Socket kapatın. Close Zaman uyumsuz bir işlem devam ederken yöntemi çağrıldığında, yöntemine BeginReceive sağlanan geri çağırma çağrılır. Yöntemine yapılan EndReceive sonraki bir çağrı, işlemin iptal edildiğini belirtmek için bir ObjectDisposedException (.NET 7'den önce) veya SocketException bir (.NET 7+'da) oluşturur.

Not

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için özelliğini kullanın SocketException.ErrorCode .

Not

Belirli bir iş parçacığı tarafından başlatılan tüm G/Ç, iş parçacığı çıktığında iptal edilir. İş parçacığı işlem tamamlanmadan önce çıkarsa bekleyen zaman uyumsuz bir işlem başarısız olabilir.

Not

state , kullanıcı tanımlı bir sınıfın örneğidir.

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'da Ağ İzleme.

Not

Yürütme bağlamı (güvenlik bağlamı, kimliğine bürünülen kullanıcı ve çağırma bağlamı) zaman uyumsuz Socket yöntemler için önbelleğe alınır. Belirli bir bağlamın (belirli bir zaman uyumsuz Socket yöntem, belirli bir örnek ve belirli Socket bir geri çağırma) ilk kullanımından sonra, bu bağlamın sonraki kullanımları bir performans geliştirmesi görecektir.

Ayrıca bkz.

• EndAccept(IAsyncResult)
• AsyncCallback
• Connect(EndPoint)
• BeginReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• Geri Çağırma Yöntemi Olarak Bir Temsilci Hazırlama
• Zaman Uyumsuz İstemci Yuvası Örneği
• Zaman Uyumsuz Sunucu Yuvası Örneği

BeginReceive(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)

Kaynak:

Socket.cs

Bağlı Socketbir 'den zaman uyumsuz olarak veri almaya başlar.

public:
 IAsyncResult ^ BeginReceive(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginReceive (byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, AsyncCallback? callback, object? state);

member this.BeginReceive : byte[] * int * int * System.Net.Sockets.SocketFlags * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceive (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, callback As AsyncCallback, state As Object) As IAsyncResult

Parametreler

buffer

Byte[]

Alınan verilerin depolama konumu olan tür Byte dizisi.

offset

Int32

Alınan verilerin depolandığı parametredeki buffer sıfır tabanlı konum.

size

Int32

Alınacak bayt sayısı.

socketFlags

SocketFlags

Değerlerin bit düzeyinde birleşimi SocketFlags .

callback

AsyncCallback

AsyncCallback İşlem tamamlandığında çağırma yöntemine başvuran bir temsilci.

state

Object

Alma işlemi hakkında bilgi içeren kullanıcı tanımlı bir nesne. İşlem tamamlandığında bu nesne temsilciye EndReceive(IAsyncResult) geçirilir.

Döndürülenler

IAsyncResult

IAsyncResult Zaman uyumsuz okumaya başvuran bir.

Özel durumlar

ArgumentNullException

buffer, null değeridir.

SocketException

Yalnızca .NET Framework ve .NET 5 ve öncesi: Yuvaya erişmeye çalışılırken bir hata oluştu.

ObjectDisposedException

Socket kapatıldı.

ArgumentOutOfRangeException

offset 0'dan küçüktür.

-veya-

offset uzunluğundan bufferbüyük.

-veya-

size 0'dan küçüktür.

-veya-

size parametresinin değerinden bufferoffset daha uzundur.

Açıklamalar

Önemli

Bu bir uyumluluk API'sidir. Yeni geliştirme için APM (Begin* ve End*) yöntemlerini kullanmanızı önermiyoruz. Bunun yerine tabanlı eşdeğerleri kullanın Task.

İşlemin AsyncCallbackBeginReceive tamamlanması hakkında bildirim almak için uygulamasına uygulanan bir geri çağırma geçirebilirsiniz. Temel alınan ağ yığını işlemi zaman uyumlu bir şekilde tamamlarsa, çağrısı sırasında geri çağırmanın BeginReceivesatır içinde yürütüleceğini unutmayın. Bu durumda, döndürülen IAsyncResult üzerindeki özelliği yöntemin CompletedSynchronously zaman uyumlu olarak tamamlandığını belirtmek için olarak ayarlanırtrue. yöntemine AsyncState geçirilen durum nesnesini almak için BeginReceive özelliğini IAsyncResult kullanın.

Zaman uyumsuz BeginReceive işlem yöntemi çağrılarak EndReceive tamamlanmalıdır. Genellikle, yöntemi temsilci tarafından çağrılır AsyncCallback . EndReceive işlem tamamlanana kadar çağıran iş parçacığını engeller.

Bekleyen BeginReceivebir öğesini iptal etmek için öğesini Socket kapatın. Close Zaman uyumsuz bir işlem devam ederken yöntemi çağrıldığında, yöntemine BeginReceive sağlanan geri çağırma çağrılır. Yöntemine yapılan EndReceive sonraki bir çağrı, işlemin iptal edildiğini belirtmek için bir ObjectDisposedException (.NET 7'den önce) veya SocketException bir (.NET 7+'da) oluşturur.

Not

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için özelliğini kullanın SocketException.ErrorCode .

Not

Belirli bir iş parçacığı tarafından başlatılan tüm G/Ç, iş parçacığı çıktığında iptal edilir. İş parçacığı işlem tamamlanmadan önce çıkarsa bekleyen zaman uyumsuz bir işlem başarısız olabilir.

Not

state , kullanıcı tanımlı bir sınıfın örneğidir.

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'da Ağ İzleme.

Not

Yürütme bağlamı (güvenlik bağlamı, kimliğine bürünülen kullanıcı ve çağırma bağlamı) zaman uyumsuz Socket yöntemler için önbelleğe alınır. Belirli bir bağlamın (belirli bir zaman uyumsuz Socket yöntem, belirli bir örnek ve belirli Socket bir geri çağırma) ilk kullanımından sonra, bu bağlamın sonraki kullanımları bir performans geliştirmesi görecektir.

Ayrıca bkz.

• EndAccept(IAsyncResult)
• AsyncCallback
• Connect(EndPoint)
• BeginReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• Geri Çağırma Yöntemi Olarak Bir Temsilci Hazırlama
• Zaman Uyumsuz İstemci Yuvası Örneği
• Zaman Uyumsuz Sunucu Yuvası Örneği

BeginReceive(IList<ArraySegment<Byte>>, SocketFlags, AsyncCallback, Object)

Kaynak:

Socket.cs

Bağlı Socketbir 'den zaman uyumsuz olarak veri almaya başlar.

public:
 IAsyncResult ^ BeginReceive(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginReceive (System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags, AsyncCallback? callback, object? state);

member this.BeginReceive : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceive (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags, callback As AsyncCallback, state As Object) As IAsyncResult

Parametreler

buffers

IList<ArraySegment<Byte>>

Alınan verilerin depolama konumu olan tür Byte dizisi.

socketFlags

SocketFlags

Değerlerin bit düzeyinde birleşimi SocketFlags .

callback

AsyncCallback

AsyncCallback İşlem tamamlandığında çağırma yöntemine başvuran bir temsilci.

state

Object

Alma işlemi hakkında bilgi içeren kullanıcı tanımlı bir nesne. İşlem tamamlandığında bu nesne temsilciye EndReceive(IAsyncResult) geçirilir.

Döndürülenler

IAsyncResult

IAsyncResult Zaman uyumsuz okumaya başvuran bir.

Özel durumlar

ArgumentNullException

buffer, null değeridir.

SocketException

Yalnızca .NET Framework ve .NET 5 ve öncesi: Yuvaya erişmeye çalışılırken bir hata oluştu.

ObjectDisposedException

Socket kapatıldı.

Açıklamalar

Önemli

Bu bir uyumluluk API'sidir. Yeni geliştirme için APM (Begin* ve End*) yöntemlerini kullanmanızı önermiyoruz. Bunun yerine tabanlı eşdeğerleri kullanın Task.

İşlemin AsyncCallbackBeginReceive tamamlanması hakkında bildirim almak için uygulamasına uygulanan bir geri çağırma geçirebilirsiniz. Temel alınan ağ yığını işlemi zaman uyumlu bir şekilde tamamlarsa, çağrısı sırasında geri çağırmanın BeginReceivesatır içinde yürütüleceğini unutmayın. Bu durumda, döndürülen IAsyncResult üzerindeki özelliği yöntemin CompletedSynchronously zaman uyumlu olarak tamamlandığını belirtmek için olarak ayarlanırtrue. yöntemine AsyncState geçirilen durum nesnesini almak için BeginReceive özelliğini IAsyncResult kullanın.

Zaman uyumsuz BeginReceive işlem yöntemi çağrılarak EndReceive tamamlanmalıdır. Genellikle, yöntemi temsilci tarafından çağrılır AsyncCallback . EndReceive işlem tamamlanana kadar çağıran iş parçacığını engeller.

Bekleyen BeginReceivebir öğesini iptal etmek için öğesini Socket kapatın. Close Zaman uyumsuz bir işlem devam ederken yöntemi çağrıldığında, yöntemine BeginReceive sağlanan geri çağırma çağrılır. Yöntemine yapılan EndReceive sonraki bir çağrı, işlemin iptal edildiğini belirtmek için bir ObjectDisposedException (.NET 7'den önce) veya SocketException bir (.NET 7+'da) oluşturur.

Not

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için özelliğini kullanın SocketException.ErrorCode .

Not

Belirli bir iş parçacığı tarafından başlatılan tüm G/Ç, iş parçacığı çıktığında iptal edilir. İş parçacığı işlem tamamlanmadan önce çıkarsa bekleyen zaman uyumsuz bir işlem başarısız olabilir.

Not

state , kullanıcı tanımlı bir sınıfın örneğidir.

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'da Ağ İzleme.

Not

Yürütme bağlamı (güvenlik bağlamı, kimliğine bürünülen kullanıcı ve çağırma bağlamı) zaman uyumsuz Socket yöntemler için önbelleğe alınır. Belirli bir bağlamın (belirli bir zaman uyumsuz Socket yöntem, belirli bir örnek ve belirli Socket bir geri çağırma) ilk kullanımından sonra, bu bağlamın sonraki kullanımları bir performans geliştirmesi görecektir.

Ayrıca bkz.

• EndAccept(IAsyncResult)
• AsyncCallback
• Connect(EndPoint)
• BeginReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• Geri Çağırma Yöntemi Olarak Bir Temsilci Hazırlama
• Zaman Uyumsuz İstemci Yuvası Örneği
• Zaman Uyumsuz Sunucu Yuvası Örneği

BeginReceive(IList<ArraySegment<Byte>>, SocketFlags, SocketError, AsyncCallback, Object)

Kaynak:

Socket.cs

Bağlı Socketbir 'den zaman uyumsuz olarak veri almaya başlar.

public:
 IAsyncResult ^ BeginReceive(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult? BeginReceive (System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode, AsyncCallback? callback, object? state);

member this.BeginReceive : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags * SocketError * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceive (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags, ByRef errorCode As SocketError, callback As AsyncCallback, state As Object) As IAsyncResult

Parametreler

buffers

IList<ArraySegment<Byte>>

Alınan verilerin depolama konumu olan tür Byte dizisi.

socketFlags

SocketFlags

Değerlerin bit düzeyinde birleşimi SocketFlags .

errorCode

SocketError

SocketError Yuva hatasını depolayan bir nesne.

callback

AsyncCallback

AsyncCallback İşlem tamamlandığında çağırma yöntemine başvuran bir temsilci.

state

Object

Alma işlemi hakkında bilgi içeren kullanıcı tanımlı bir nesne. İşlem tamamlandığında bu nesne temsilciye EndReceive(IAsyncResult) geçirilir.

Döndürülenler

IAsyncResult

IAsyncResult Zaman uyumsuz okumaya başvuran bir.

Özel durumlar

ArgumentNullException

buffer, null değeridir.

SocketException

Yalnızca .NET Framework ve .NET 5 ve öncesi: Yuvaya erişmeye çalışılırken bir hata oluştu.

ObjectDisposedException

Socket kapatıldı.

Açıklamalar

Önemli

Bu bir uyumluluk API'sidir. Yeni geliştirme için APM (Begin* ve End*) yöntemlerini kullanmanızı önermiyoruz. Bunun yerine tabanlı eşdeğerleri kullanın Task.

İşlemin AsyncCallbackBeginReceive tamamlanması hakkında bildirim almak için uygulamasına uygulanan bir geri çağırma geçirebilirsiniz. Temel alınan ağ yığını işlemi zaman uyumlu bir şekilde tamamlarsa, çağrısı sırasında geri çağırmanın BeginReceivesatır içinde yürütüleceğini unutmayın. Bu durumda, döndürülen IAsyncResult üzerindeki özelliği yöntemin CompletedSynchronously zaman uyumlu olarak tamamlandığını belirtmek için olarak ayarlanırtrue. yöntemine AsyncState geçirilen durum nesnesini almak için BeginReceive özelliğini IAsyncResult kullanın.

Zaman uyumsuz BeginReceive işlem yöntemi çağrılarak EndReceive tamamlanmalıdır. Genellikle, yöntemi temsilci tarafından çağrılır AsyncCallback . EndReceive işlem tamamlanana kadar çağıran iş parçacığını engeller.

Bekleyen BeginReceivebir öğesini iptal etmek için öğesini Socket kapatın. Close Zaman uyumsuz bir işlem devam ederken yöntemi çağrıldığında, yöntemine BeginReceive sağlanan geri çağırma çağrılır. Yöntemine yapılan EndReceive sonraki bir çağrı, işlemin iptal edildiğini belirtmek için bir ObjectDisposedException (.NET 7'den önce) veya SocketException bir (.NET 7+'da) oluşturur.

Not

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için özelliğini kullanın SocketException.ErrorCode .

Not

Belirli bir iş parçacığı tarafından başlatılan tüm G/Ç, iş parçacığı çıktığında iptal edilir. İş parçacığı işlem tamamlanmadan önce çıkarsa bekleyen zaman uyumsuz bir işlem başarısız olabilir.

Not

state , kullanıcı tanımlı bir sınıfın örneğidir.

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'da Ağ İzleme.

Not

Yürütme bağlamı (güvenlik bağlamı, kimliğine bürünülen kullanıcı ve çağırma bağlamı) zaman uyumsuz Socket yöntemler için önbelleğe alınır. Belirli bir bağlamın (belirli bir zaman uyumsuz Socket yöntem, belirli bir örnek ve belirli Socket bir geri çağırma) ilk kullanımından sonra, bu bağlamın sonraki kullanımları bir performans geliştirmesi görecektir.

Ayrıca bkz.

• EndAccept(IAsyncResult)
• AsyncCallback
• Connect(EndPoint)
• BeginReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• Geri Çağırma Yöntemi Olarak Bir Temsilci Hazırlama
• Zaman Uyumsuz İstemci Yuvası Örneği
• Zaman Uyumsuz Sunucu Yuvası Örneği