SocketOptionName Enum
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menentukan nama opsi konfigurasi.
public enum class SocketOptionNamepublic enum SocketOptionNametype SocketOptionName = Public Enum SocketOptionName- Warisan
Bidang
| Nama | Nilai | Deskripsi |
|---|---|---|
| DontLinger | -129 | Tutup soket dengan anggun tanpa berlama-lama. |
| ExclusiveAddressUse | -5 | Memungkinkan soket terikat untuk akses eksklusif. |
| Debug | 1 | Rekam informasi penelusuran kesalahan. |
| IPOptions | 1 | Menentukan opsi IP yang akan disisipkan ke dalam datagram keluar. |
| NoChecksum | 1 | Kirim datagram UDP dengan checksum diatur ke nol. |
| NoDelay | 1 | Menonaktifkan algoritma Nagle untuk mengirim coalescing. |
| AcceptConnection | 2 | Soket mendengarkan. |
| BsdUrgent | 2 | Gunakan data mendesak seperti yang didefinisikan dalam RFC-1222. Opsi ini hanya dapat diatur sekali; setelah diatur, tidak dapat dimatikan. |
| Expedited | 2 | Gunakan data yang dipercepat seperti yang didefinisikan dalam RFC-1222. Opsi ini hanya dapat diatur sekali; setelah diatur, tidak dapat dimatikan. |
| HeaderIncluded | 2 | Menunjukkan bahwa aplikasi menyediakan header IP untuk datagram keluar. |
| TcpKeepAliveTime | 3 | Jumlah detik koneksi TCP akan tetap hidup/menganggur sebelum pemeriksaan keepalive dikirim ke remote. |
| TypeOfService | 3 | Ubah jenis header IP bidang layanan. |
| IpTimeToLive | 4 | Atur bidang Time-to-Live header IP. |
| ReuseAddress | 4 | Memungkinkan soket terikat ke alamat yang sudah digunakan. |
| KeepAlive | 8 | Gunakan tetap hidup. |
| MulticastInterface | 9 | Atur antarmuka untuk paket multicast keluar. |
| MulticastTimeToLive | 10 | An IP multicast Time to Live. |
| MulticastLoopback | 11 | Perulangan multicast IP. |
| AddMembership | 12 | Tambahkan keanggotaan grup IP. |
| DropMembership | 13 | Hilangkan keanggotaan grup IP. |
| DontFragment | 14 | Jangan fragmen datagram IP. |
| AddSourceMembership | 15 | Bergabung dengan grup sumber. |
| FastOpen | 15 | Mengaktifkan TCP Fast Open seperti yang didefinisikan dalam RFC-7413. Perilaku aktual yang diamati tergantung pada konfigurasi OS dan status cache cookie TCP kernel. Menggunakan TFO hanya direkomendasikan dalam lingkungan jaringan terkontrol, yang berarti bahwa setiap middlebox (misalnya, firewall, router, proksi) pada jalur jaringan antara klien dan server diketahui dan dapat dikonfigurasi untuk mendukung TFO. Menggunakan TFO di luar lingkungan terkontrol (seperti internet terbuka) dapat menyebabkan masalah konektivitas. |
| DontRoute | 16 | Jangan rutekan; kirim paket langsung ke alamat antarmuka. |
| DropSourceMembership | 16 | Hilangkan grup sumber. |
| TcpKeepAliveRetryCount | 16 | Jumlah pemeriksaan tetap aktif TCP yang akan dikirim sebelum koneksi dihentikan. |
| BlockSource | 17 | Memblokir data dari sumber. |
| TcpKeepAliveInterval | 17 | Jumlah detik koneksi TCP akan menunggu respons keepalive sebelum mengirim pemeriksaan keepalive lainnya. |
| UnblockSource | 18 | Buka blokir sumber yang diblokir sebelumnya. |
| PacketInformation | 19 | Mengembalikan informasi tentang paket yang diterima. |
| ChecksumCoverage | 20 | Atur atau dapatkan cakupan checksum UDP. |
| HopLimit | 21 | Menentukan jumlah maksimum lompatan router untuk paket Protokol Internet versi 6 (IPv6). Ini mirip dengan Time to Live (TTL) untuk Protokol Internet versi 4. |
| IPProtectionLevel | 23 | Mengaktifkan pembatasan soket IPv6 ke cakupan tertentu, seperti alamat dengan awalan lokal tautan yang sama atau lokal situs. Opsi soket ini memungkinkan aplikasi untuk menempatkan pembatasan akses pada soket IPv6. Pembatasan tersebut memungkinkan aplikasi yang berjalan pada LAN privat untuk secara sederhana dan kuat memperkuat dirinya terhadap serangan eksternal. Opsi soket ini memperlebar atau mempersempit cakupan soket mendengarkan, memungkinkan akses tidak terbatas dari pengguna publik dan privat jika sesuai, atau membatasi akses hanya ke situs yang sama, sesuai kebutuhan. Opsi soket ini telah menentukan tingkat perlindungan yang ditentukan dalam IPProtectionLevel enumerasi. |
| IPv6Only | 27 | Menunjukkan apakah soket yang dibuat untuk keluarga alamat AF_INET6 hanya dibatasi untuk komunikasi IPv6. Soket yang dibuat untuk keluarga alamat AF_INET6 dapat digunakan untuk komunikasi IPv6 dan IPv4. Beberapa aplikasi mungkin ingin membatasi penggunaan soket yang dibuat hanya untuk keluarga alamat AF_INET6 ke komunikasi IPv6. Ketika nilai ini bukan nol (default pada Windows), soket yang dibuat untuk keluarga alamat AF_INET6 dapat digunakan untuk mengirim dan menerima paket IPv6 saja. Ketika nilai ini nol, soket yang dibuat untuk keluarga alamat AF_INET6 dapat digunakan untuk mengirim dan menerima paket ke dan dari alamat IPv6 atau alamat IPv4. Perhatikan bahwa kemampuan untuk berinteraksi dengan alamat IPv4 memerlukan penggunaan alamat yang dipetakan IPv4. Opsi soket ini didukung pada Windows Vista atau yang lebih baru. |
| Broadcast | 32 | Mengizinkan pengiriman pesan siaran di soket. |
| UseLoopback | 64 | Lewati perangkat keras jika memungkinkan. |
| Linger | 128 | Berlama-lama di dekat jika data yang tidak terkiron ada. |
| OutOfBandInline | 256 | Menerima data di luar band dalam aliran data normal. |
| SendBuffer | 4097 | Menentukan total ruang buffer per soket yang dicadangkan untuk pengiriman. Ini tidak terkait dengan ukuran pesan maksimum atau ukuran jendela TCP. |
| ReceiveBuffer | 4098 | Menentukan total ruang buffer per soket yang dicadangkan untuk penerimaan. Ini tidak terkait dengan ukuran pesan maksimum atau ukuran jendela TCP. |
| SendLowWater | 4099 | Menentukan tanda air rendah untuk Send operasi. |
| ReceiveLowWater | 4100 | Menentukan tanda air rendah untuk Receive operasi. |
| SendTimeout | 4101 | Kirim waktu habis. Opsi ini hanya berlaku untuk metode sinkron; tidak berpengaruh pada metode asinkron seperti BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) metode . |
| ReceiveTimeout | 4102 | Menerima waktu habis. Opsi ini hanya berlaku untuk metode sinkron; tidak berpengaruh pada metode asinkron seperti BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) metode . |
| Error | 4103 | Mendapatkan status kesalahan dan bersih. |
| Type | 4104 | Mendapatkan jenis soket. |
| ReuseUnicastPort | 12295 | Menunjukkan bahwa sistem harus menukar alokasi port ephemeral untuk koneksi keluar. Ini setara dengan menggunakan opsi soket Winsock2 SO_REUSE_UNICASTPORT. |
| UpdateAcceptContext | 28683 | Memperbarui properti soket yang diterima dengan menggunakan soket yang ada. Ini setara dengan menggunakan opsi soket Winsock2 SO_UPDATE_ACCEPT_CONTEXT dan hanya didukung pada soket berorientasi koneksi. |
| UpdateConnectContext | 28688 | Memperbarui properti soket yang terhubung dengan menggunakan soket yang ada. Ini setara dengan menggunakan opsi soket Winsock2 SO_UPDATE_CONNECT_CONTEXT dan hanya didukung pada soket berorientasi koneksi. |
| MaxConnections | 2147483647 | Tidak didukung; akan melempar jika SocketException digunakan. |
Contoh
Contoh kode berikut menggunakan enumerasi ini untuk mengatur opsi soket.
// The socket will linger for 10 seconds after Socket.Close is called.
var lingerOption = new LingerOption(true, 10);
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption);
' The socket will linger for 10 seconds after Socket.Close is called.
Dim lingerOption As New LingerOption(True, 10)
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption)
Keterangan
Enumerasi SocketOptionName menentukan nama setiap Socket opsi konfigurasi. Soket dapat dikonfigurasi dengan Socket.SetSocketOption metode .
