Socket 类
实现 Berkeley 套接字接口。
命名空间: 程序集: System(在 System.dll 中)
public class Socket : IDisposable
Socket 类型公开以下成员。
名称 | 说明 | |
---|---|---|
使用 返回的指定的值初始化 Socket 类的新实例。 | ||
使用指定的地址族、套接字类型和协议初始化 Socket 类的新实例。 | ||
使用指定的地址族、套接字类型和协议初始化 Socket 类的新实例。 |
名称 | 说明 | |
---|---|---|
获取 Socket 的地址族。 | ||
获取已经从网络接收且可供读取的数据量。 | ||
获取或设置一个值,该值指示 Socket 是否处于阻止模式。 | ||
获取一个值,该值指示 Socket 在上次 或者 操作时是否连接到远程主机。 | ||
获取或设置 值,该值指定 Socket 是否允许将 Internet 协议 (IP) 数据报分段。 | ||
获取或设置一个 值,它指定 Socket 是否是用于 IPv4 和 IPv6 的双模式套接字。 | ||
获取或设置一个 值,该值指定 Socket 是否可以发送或接收广播数据包。 | ||
获取或设置 值,该值指定 Socket 是否仅允许一个进程绑定到端口。 | ||
获取 Socket 的操作系统句柄。 | ||
获取一个值,该值指示 Socket 是否绑定到特定本地端口。 | ||
获取或设置一个值,该值指定 Socket 在尝试发送所有挂起数据时是否延迟关闭套接字。 | ||
获取本地终结点。 | ||
获取或设置一个值,该值指定传出的多路广播数据包是否传递到发送应用程序。 | ||
获取或设置 值,该值指定流 Socket 是否正在使用 Nagle 算法。 | ||
指示基础操作系统和网络适配器是否支持 Internet 协议第 4 版 (IPv4)。 | ||
指示基础操作系统和网络适配器是否支持 Internet 协议第 6 版 (IPv6)。 | ||
获取 Socket 的协议类型。 | ||
获取或设置一个值,它指定 Socket 接收缓冲区的大小。 | ||
获取或设置一个值,该值指定之后同步 调用将超时的时间长度。 | ||
获取远程终结点。 | ||
获取或设置一个值,该值指定 Socket 发送缓冲区的大小。 | ||
获取或设置一个值,该值指定之后同步 调用将超时的时间长度。 | ||
获取 Socket 的类型。 | ||
已过时。获取一个值,该值指示在当前主机上 IPv4 支持是否可用并且已启用。 | ||
已过时。获取一个值,该值指示 Framework 对某些已过时的 成员是否支持 IPv6。 | ||
获取或设置一个值,指定 Socket 发送的 Internet 协议 (IP) 数据包的生存时间 (TTL) 值。 | ||
指定套接字是否应仅使用重叠 I/O 模式。 |
名称 | 说明 | |
---|---|---|
为新建连接创建新的 Socket。 | ||
开始一个异步操作来接受一个传入的连接尝试。 | ||
开始一个异步操作来接受一个传入的连接尝试。 | ||
开始异步操作以接受传入的连接尝试并接收客户端应用程序发送的第一个数据块。 | ||
开始异步操作以接受从指定套接字传入的连接尝试并接收客户端应用程序发送的第一个数据块。 | ||
开始一个对远程主机连接的异步请求。 | ||
开始一个对远程主机连接的异步请求。 主机由 和端口号指定。 | ||
开始一个对远程主机连接的异步请求。 主机由 数组和端口号指定。 | ||
开始一个对远程主机连接的异步请求。 主机由主机名和端口号指定。 | ||
开始异步请求从远程终结点断开连接。 | ||
开始从连接的 Socket 中异步接收数据。 | ||
开始从连接的 Socket 中异步接收数据。 | ||
开始从连接的 Socket 中异步接收数据。 | ||
开始从连接的 Socket 中异步接收数据。 | ||
开始从指定网络设备中异步接收数据。 | ||
开始使用指定的 将指定字节数的数据异步接收到数据缓冲区的指定位置,然后存储终结点和数据包信息。 | ||
将数据异步发送到连接的 Socket。 | ||
将数据异步发送到连接的 Socket。 | ||
将数据异步发送到连接的 Socket。 | ||
将数据异步发送到连接的 Socket。 | ||
使用 标志,将文件 fileName 发送到连接的 Socket 对象。 | ||
将文件和数据缓冲区异步发送到连接的 Socket 对象。 | ||
向特定远程主机异步发送数据。 | ||
使 Socket 与一个本地终结点相关联。 | ||
取消一个对远程主机连接的异步请求。 | ||
关闭 Socket 连接并释放所有关联的资源。 | ||
关闭 Socket 连接并释放与指定超时关联的所有资源以允许发送排队数据。 | ||
建立与远程主机的连接。 | ||
建立与远程主机的连接。 主机由 IP 地址和端口号指定。 | ||
建立与远程主机的连接。 主机由 IP 地址的数组和端口号指定。 | ||
建立与远程主机的连接。 主机由主机名和端口号指定。 | ||
开始一个对远程主机连接的异步请求。 | ||
开始一个对远程主机连接的异步请求。 | ||
关闭套接字连接并允许重用套接字。 | ||
开始异步请求从远程终结点断开连接。 | ||
释放由 Socket 类的当前实例占用的所有资源。 | ||
释放由 Socket 使用的非托管资源,并可根据需要释放托管资源。 | ||
重复目标进程的套接字引用,并关闭此进程的套接字。 | ||
异步接受传入的连接尝试,并创建新的 Socket 来处理远程主机通信。 | ||
异步接受传入的连接尝试,并创建新的 Socket 对象来处理远程主机通信。 此方法返回包含所传输的初始数据的缓冲区。 | ||
异步接受传入的连接尝试,并创建新的 Socket 对象来处理远程主机通信。 此方法返回一个缓冲区,其中包含初始数据和传输的字节数。 | ||
结束挂起的异步连接请求。 | ||
结束挂起的异步断开连接请求。 | ||
结束挂起的异步读取。 | ||
结束挂起的异步读取。 | ||
结束挂起的、从特定终结点进行异步读取。 | ||
结束挂起的、从特定终结点进行异步读取。 此方法还显示有关数据包而不是 的更多信息。 | ||
结束挂起的异步发送。 | ||
结束挂起的异步发送。 | ||
结束文件的挂起异步发送。 | ||
结束挂起的、向指定位置进行的异步发送。 | ||
确定指定的对象是否等于当前对象。 (继承自 。) | ||
释放 Socket 类使用的资源。 (重写 。) | ||
作为默认哈希函数。 (继承自 。) | ||
返回指定的 Socket 选项的值,表示为一个对象。 | ||
返回指定的 Socket 选项设置,表示为字节数组。 | ||
返回数组中指定的 Socket 选项的值。 | ||
获取当前实例的 。 (继承自 。) | ||
使用数字控制代码,为 Socket 设置低级操作模式。 | ||
使用 枚举指定控制代码,为 Socket 设置低级操作模式。 | ||
将 Socket 置于侦听状态。 | ||
创建当前 的浅表副本。 (继承自 。) | ||
确定 Socket 的状态。 | ||
从绑定的 Socket 接收数据,将数据存入接收缓冲区列表中。 | ||
从绑定的 Socket 套接字接收数据,将数据存入接收缓冲区。 | ||
使用指定的 ,从绑定的 Socket 接收数据,将数据存入接收缓冲区列表中。 | ||
使用指定的 ,从绑定的 Socket 接收数据,将数据存入接收缓冲区。 | ||
使用指定的 ,从绑定的 Socket 接收数据,将数据存入接收缓冲区列表中。 | ||
使用指定的 ,从绑定的 Socket 接收指定字节数的数据,并将数据存入接收缓冲区。 | ||
使用指定的 ,从绑定的 Socket 接收指定的字节数,存入接收缓冲区的指定偏移量位置。 | ||
使用指定的 ,从绑定的 Socket 接收数据,将数据存入接收缓冲区。 | ||
开始一个异步请求以便从连接的 Socket 对象中接收数据。 | ||
将数据报接收到数据缓冲区并存储终结点。 | ||
使用指定的 将数据报接收到数据缓冲区并存储终结点。 | ||
使用指定的 将指定的字节数接收到数据缓冲区并存储终结点。 | ||
使用指定的 将指定字节数的数据接收到数据缓冲区的指定位置并存储终结点。 | ||
开始从指定网络设备中异步接收数据。 | ||
使用指定的 将指定字节数的数据接收到数据缓冲区的指定位置,然后存储终结点和数据包信息。 | ||
开始使用指定的 将指定字节数的数据异步接收到数据缓冲区的指定位置,并存储终结点和数据包信息。 | ||
确定一个或多个套接字的状态。 | ||
将列表中的一组缓冲区发送到连接的 Socket。 | ||
将数据发送到连接的 Socket。 | ||
使用指定的 ,将列表中的一组缓冲区发送到连接的Socket。 | ||
使用指定的 将数据发送到连接的 Socket。 | ||
使用指定的 ,将列表中的一组缓冲区发送到连接的Socket。 | ||
使用指定的 ,将指定字节数的数据发送到已连接的Socket。 | ||
使用指定的 ,将指定字节数的数据发送到已连接的Socket(从指定的偏移量开始)。 | ||
从指定的偏移量开始使用指定的 将指定字节数的数据发送到连接的 Socket。 | ||
将数据异步发送到连接的 Socket 对象。 | ||
使用 传输标志,将文件 fileName发送到连接的 Socket 对象。 | ||
使用指定的 值,将文件 fileName 和数据缓冲区发送到连接的 Socket 对象。 | ||
将文件集合或者内存中的数据缓冲区以异步方法发送给连接的Socket 对象。 | ||
将数据发送到指定的终结点。 | ||
使用指定的 ,将数据发送到特定的终结点。 | ||
使用指定的 ,将指定字节数的数据发送到指定的终结点。 | ||
使用指定的 ,将指定字节数的数据发送到指定终结点(从缓冲区中的指定位置开始)。 | ||
向特定远程主机异步发送数据。 | ||
设置套接字的 IP 保护级别。 | ||
将指定的 Socket 选项设置为指定的 值。 | ||
将指定的 Socket 选项设置为指定的值,表示为字节数组。 | ||
将指定的 Socket 选项设置为指定的整数值。 | ||
将指定的 Socket 选项设置为指定值,表示为对象。 | ||
禁用某 Socket 上的发送和接收。 | ||
返回表示当前对象的字符串。 (继承自 。) |
Socket 类为网络通信提供了一套丰富的方法和属性。 Socket 类允许您使用 枚举中所列出的任何一种协议执行异步和同步数据传输。
Socket 类对异步方法遵循 .NET Framework 命名模式。 例如,同步的 方法对应于异步的 和 方法。
如果应用程序在执行期间只需要一个线程,请使用下面的方法,这些方法适用于同步操作模式。
-
如果当前使用的是面向连接的协议(如 TCP),则服务器可以使用 方法侦听连接。 方法处理任何传入的连接请求,并返回可用于与远程主机进行数据通信的 Socket。 可以使用此返回的 Socket 来调用 或 方法。 如果要指定本地 IP 地址和端口号,请在调用 方法之前先调用 方法。 如果您希望基础服务提供程序为您分配可用端口,请使用端口号 0。 如果希望连接到侦听主机,请调用 方法。 若要进行数据通信,请调用 或 方法。
-
如果当前使用的是无连接协议(如 UDP),则根本不需要侦听连接。 调用 方法可接受任何传入的数据报。 使用 方法可将数据报发送到远程主机。
若要在执行过程中使用单独的线程处理通信,请使用下面的方法,这些方法适用于异步操作模式。
-
如果当前使用的是面向连接的协议(如 TCP),则可使用 Socket、 和 方法来连接侦听主机。 通过使用 和 方法,或者使用 和 方法,可以进行异步数据通信。 可以使用 和 处理传入的连接请求。
-
如果您使用的是 UDP 等无连接协议,则可以使用 和 来发送数据报,而使用 和 来接收数据报。
如果对一个套接字执行多个异步操作,它们不一定按启动时的顺序完成。
当数据发送和数据接收完成之后,可使用 方法来禁用 Socket。 在调用 之后,可调用 方法来释放与 Socket 关联的所有资源。
通过 Socket 类,您可以使用 方法来配置 Socket。 可以使用 方法来检索这些设置。
说明 |
---|
如果要编写相对简单的应用程序,而且不需要最高的性能,则可以考虑使用 、 和 。 这些类为 Socket 通信提供了更简单、对用户更友好的接口。 |
下面的代码示例演示如何使用 Socket 类向 HTTP 服务器发送数据和接收响应。 接收到整个页前,此示例将一直处于阻止状态。
using System;using System.Text;using System.IO;using System.Net;using System.Net.Sockets;public class GetSocket{ private static Socket ConnectSocket(string server, int port) { Socket s = null; IPHostEntry hostEntry = null; // Get host related information. hostEntry = Dns.GetHostEntry(server); // Loop through the AddressList to obtain the supported AddressFamily. This is to avoid // an exception that occurs when the host IP Address is not compatible with the address family // (typical in the IPv6 case). foreach(IPAddress address in hostEntry.AddressList) { IPEndPoint ipe = new IPEndPoint(address, port); Socket tempSocket = new Socket(ipe.AddressFamily, SocketType.Stream, ProtocolType.Tcp); tempSocket.Connect(ipe); if(tempSocket.Connected) { s = tempSocket; break; } else { continue; } } return s; } // This method requests the home page content for the specified server. private static string SocketSendReceive(string server, int port) { string request = "GET / HTTP/1.1\r\nHost: " + server + "\r\nConnection: Close\r\n\r\n"; Byte[] bytesSent = Encoding.ASCII.GetBytes(request); Byte[] bytesReceived = new Byte[256]; // Create a socket connection with the specified server and port. Socket s = ConnectSocket(server, port); if (s == null) return ("Connection failed"); // Send request to the server. s.Send(bytesSent, bytesSent.Length, 0); // Receive the server home page content. int bytes = 0; string page = "Default HTML page on " + server + ":\r\n"; // The following will block until te page is transmitted. do { bytes = s.Receive(bytesReceived, bytesReceived.Length, 0); page = page + Encoding.ASCII.GetString(bytesReceived, 0, bytes); } while (bytes > 0); return page; } public static void Main(string[] args) { string host; int port = 80; if (args.Length == 0) // If no server name is passed as argument to this program, // use the current host name as the default. host = Dns.GetHostName(); else host = args[0]; string result = SocketSendReceive(host, port); Console.WriteLine(result); }}
此类的实例是线程安全的。