Socket.BeginReceive Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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
- Kaynak:
- Socket.cs
- 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);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 -> IAsyncResultPublic 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 IAsyncResultParametreler
- 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 Zaman uyumsuz okumaya başvuran bir.
Özel durumlar
buffer, null değeridir.
Yalnızca .NET Framework ve .NET 5 ve öncesi: Yuvaya erişmeye çalışılırken bir hata oluştu.
Socket kapatıldı.
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
Şunlara uygulanır
BeginReceive(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)
- Kaynak:
- Socket.cs
- Kaynak:
- Socket.cs
- 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);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 -> IAsyncResultPublic Function BeginReceive (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, callback As AsyncCallback, state As Object) As IAsyncResultParametreler
- 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 Zaman uyumsuz okumaya başvuran bir.
Özel durumlar
buffer, null değeridir.
Yalnızca .NET Framework ve .NET 5 ve öncesi: Yuvaya erişmeye çalışılırken bir hata oluştu.
Socket kapatıldı.
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
Şunlara uygulanır
BeginReceive(IList<ArraySegment<Byte>>, SocketFlags, AsyncCallback, Object)
- Kaynak:
- Socket.cs
- Kaynak:
- Socket.cs
- 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);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 -> IAsyncResultPublic Function BeginReceive (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags, callback As AsyncCallback, state As Object) As IAsyncResultParametreler
- 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 Zaman uyumsuz okumaya başvuran bir.
Özel durumlar
buffer, null değeridir.
Yalnızca .NET Framework ve .NET 5 ve öncesi: Yuvaya erişmeye çalışılırken bir hata oluştu.
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
Şunlara uygulanır
BeginReceive(IList<ArraySegment<Byte>>, SocketFlags, SocketError, AsyncCallback, Object)
- Kaynak:
- Socket.cs
- Kaynak:
- Socket.cs
- 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);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 -> IAsyncResultPublic Function BeginReceive (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags, ByRef errorCode As SocketError, callback As AsyncCallback, state As Object) As IAsyncResultParametreler
- 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 Zaman uyumsuz okumaya başvuran bir.
Özel durumlar
buffer, null değeridir.
Yalnızca .NET Framework ve .NET 5 ve öncesi: Yuvaya erişmeye çalışılırken bir hata oluştu.
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
Şunlara uygulanır
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin