Socket Class中文解释

Socket 类

.NET Framework 4.6 and 4.5

实现 Berkeley 套接字接口。

System.Object 
   System.Net.Sockets.Socket

 

命名空间:   System.Net.Sockets
程序集:  System(在 System.dll 中)
语法
 
C#
 
public class Socket : IDisposable

Socket 类型公开以下成员。

显示: 继承 保护
 名称说明
公共方法Socket(SocketInformation)使用 DuplicateAndClose 返回的指定的值初始化 Socket 类的新实例。
公共方法Socket(SocketType, ProtocolType)使用指定的地址族、套接字类型和协议初始化 Socket 类的新实例。
公共方法Socket(AddressFamily, SocketType, ProtocolType)使用指定的地址族、套接字类型和协议初始化 Socket 类的新实例。
页首

属性

 
显示: 继承 保护
 名称说明
公共属性AddressFamily获取 Socket 的地址族。
公共属性Available获取已经从网络接收且可供读取的数据量。
公共属性Blocking获取或设置一个值,该值指示 Socket 是否处于阻止模式。
公共属性Connected获取一个值,该值指示 Socket 在上次 Send 或者 Receive 操作时是否连接到远程主机。
公共属性DontFragment获取或设置 Boolean 值,该值指定 Socket 是否允许将 Internet 协议 (IP) 数据报分段。
公共属性DualMode获取或设置一个 Boolean 值,它指定 Socket 是否是用于 IPv4 和 IPv6 的双模式套接字。
公共属性EnableBroadcast获取或设置一个 Boolean 值,该值指定 Socket 是否可以发送或接收广播数据包。
公共属性ExclusiveAddressUse获取或设置 Boolean 值,该值指定 Socket 是否仅允许一个进程绑定到端口。
公共属性Handle获取 Socket 的操作系统句柄。
公共属性IsBound获取一个值,该值指示 Socket 是否绑定到特定本地端口。
公共属性LingerState获取或设置一个值,该值指定 Socket 在尝试发送所有挂起数据时是否延迟关闭套接字。
公共属性LocalEndPoint获取本地终结点。
公共属性MulticastLoopback获取或设置一个值,该值指定传出的多路广播数据包是否传递到发送应用程序。
公共属性NoDelay获取或设置 Boolean 值,该值指定流 Socket 是否正在使用 Nagle 算法。
公共属性静态成员OSSupportsIPv4指示基础操作系统和网络适配器是否支持 Internet 协议第 4 版 (IPv4)。
公共属性静态成员OSSupportsIPv6指示基础操作系统和网络适配器是否支持 Internet 协议第 6 版 (IPv6)。
公共属性ProtocolType获取 Socket 的协议类型。
公共属性ReceiveBufferSize获取或设置一个值,它指定 Socket 接收缓冲区的大小。
公共属性ReceiveTimeout获取或设置一个值,该值指定之后同步 Receive 调用将超时的时间长度。
公共属性RemoteEndPoint获取远程终结点。
公共属性SendBufferSize获取或设置一个值,该值指定 Socket 发送缓冲区的大小。
公共属性SendTimeout获取或设置一个值,该值指定之后同步 Send 调用将超时的时间长度。
公共属性SocketType获取 Socket 的类型。
公共属性静态成员SupportsIPv4已过时。获取一个值,该值指示在当前主机上 IPv4 支持是否可用并且已启用。
公共属性静态成员SupportsIPv6已过时。获取一个值,该值指示 Framework 对某些已过时的Dns 成员是否支持 IPv6。
公共属性Ttl获取或设置一个值,指定 Socket 发送的 Internet 协议 (IP) 数据包的生存时间 (TTL) 值。
公共属性UseOnlyOverlappedIO指定套接字是否应仅使用重叠 I/O 模式。
页首

方法

 
显示: 继承 保护
 名称说明
公共方法Accept为新建连接创建新的 Socket。
公共方法AcceptAsync开始一个异步操作来接受一个传入的连接尝试。
公共方法BeginAccept(AsyncCallback, Object)开始一个异步操作来接受一个传入的连接尝试。
公共方法BeginAccept(Int32, AsyncCallback, Object)开始异步操作以接受传入的连接尝试并接收客户端应用程序发送的第一个数据块。
公共方法BeginAccept(Socket, Int32, AsyncCallback, Object)开始异步操作以接受从指定套接字传入的连接尝试并接收客户端应用程序发送的第一个数据块。
公共方法BeginConnect(EndPoint, AsyncCallback, Object)开始一个对远程主机连接的异步请求。
公共方法BeginConnect(IPAddress, Int32, AsyncCallback, Object)开始一个对远程主机连接的异步请求。 主机由 IPAddress 和端口号指定。
公共方法BeginConnect(IPAddress[], Int32, AsyncCallback, Object)开始一个对远程主机连接的异步请求。 主机由 IPAddress 数组和端口号指定。
公共方法BeginConnect(String, Int32, AsyncCallback, Object)开始一个对远程主机连接的异步请求。 主机由主机名和端口号指定。
公共方法BeginDisconnect开始异步请求从远程终结点断开连接。
公共方法BeginReceive(IList<ArraySegment<Byte>>, SocketFlags, AsyncCallback, Object)开始从连接的 Socket 中异步接收数据。
公共方法BeginReceive(IList<ArraySegment<Byte>>, SocketFlags, SocketError, AsyncCallback, Object)开始从连接的 Socket 中异步接收数据。
公共方法BeginReceive(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)开始从连接的 Socket 中异步接收数据。
公共方法BeginReceive(Byte[], Int32, Int32, SocketFlags, SocketError, AsyncCallback, Object)开始从连接的 Socket 中异步接收数据。
公共方法BeginReceiveFrom开始从指定网络设备中异步接收数据。
公共方法BeginReceiveMessageFrom开始使用指定的 SocketFlags 将指定字节数的数据异步接收到数据缓冲区的指定位置,然后存储终结点和数据包信息。
公共方法BeginSend(IList<ArraySegment<Byte>>, SocketFlags, AsyncCallback, Object)将数据异步发送到连接的 Socket。
公共方法BeginSend(IList<ArraySegment<Byte>>, SocketFlags, SocketError, AsyncCallback, Object)将数据异步发送到连接的 Socket。
公共方法BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)将数据异步发送到连接的 Socket。
公共方法BeginSend(Byte[], Int32, Int32, SocketFlags, SocketError, AsyncCallback, Object)将数据异步发送到连接的 Socket。
公共方法BeginSendFile(String, AsyncCallback, Object)使用 UseDefaultWorkerThread 标志,将文件 fileName 发送到连接的 Socket 对象。
公共方法BeginSendFile(String, Byte[], Byte[], TransmitFileOptions, AsyncCallback, Object)将文件和数据缓冲区异步发送到连接的 Socket 对象。
公共方法BeginSendTo向特定远程主机异步发送数据。
公共方法Bind使 Socket 与一个本地终结点相关联。
公共方法静态成员CancelConnectAsync取消一个对远程主机连接的异步请求。
公共方法Close()关闭 Socket 连接并释放所有关联的资源。
公共方法Close(Int32)关闭 Socket 连接并释放与指定超时关联的所有资源以允许发送排队数据。
公共方法Connect(EndPoint)建立与远程主机的连接。
公共方法Connect(IPAddress, Int32)建立与远程主机的连接。 主机由 IP 地址和端口号指定。
公共方法Connect(IPAddress[], Int32)建立与远程主机的连接。 主机由 IP 地址的数组和端口号指定。
公共方法Connect(String, Int32)建立与远程主机的连接。 主机由主机名和端口号指定。
公共方法ConnectAsync(SocketAsyncEventArgs)开始一个对远程主机连接的异步请求。
公共方法静态成员ConnectAsync(SocketType, ProtocolType, SocketAsyncEventArgs)开始一个对远程主机连接的异步请求。
公共方法Disconnect关闭套接字连接并允许重用套接字。
公共方法DisconnectAsync开始异步请求从远程终结点断开连接。
公共方法Dispose()释放由 Socket 类的当前实例占用的所有资源。
受保护的方法Dispose(Boolean)释放由 Socket 使用的非托管资源,并可根据需要释放托管资源。
公共方法DuplicateAndClose重复目标进程的套接字引用,并关闭此进程的套接字。
公共方法EndAccept(IAsyncResult)异步接受传入的连接尝试,并创建新的 Socket 来处理远程主机通信。
公共方法EndAccept(Byte[], IAsyncResult)异步接受传入的连接尝试,并创建新的 Socket 对象来处理远程主机通信。 此方法返回包含所传输的初始数据的缓冲区。
公共方法EndAccept(Byte[], Int32, IAsyncResult)异步接受传入的连接尝试,并创建新的 Socket 对象来处理远程主机通信。 此方法返回一个缓冲区,其中包含初始数据和传输的字节数。
公共方法EndConnect结束挂起的异步连接请求。
公共方法EndDisconnect结束挂起的异步断开连接请求。
公共方法EndReceive(IAsyncResult)结束挂起的异步读取。
公共方法EndReceive(IAsyncResult, SocketError)结束挂起的异步读取。
公共方法EndReceiveFrom结束挂起的、从特定终结点进行异步读取。
公共方法EndReceiveMessageFrom结束挂起的、从特定终结点进行异步读取。 此方法还显示有关数据包而不是 EndReceiveFrom 的更多信息。
公共方法EndSend(IAsyncResult)结束挂起的异步发送。
公共方法EndSend(IAsyncResult, SocketError)结束挂起的异步发送。
公共方法EndSendFile结束文件的挂起异步发送。
公共方法EndSendTo结束挂起的、向指定位置进行的异步发送。
公共方法Equals(Object)确定指定的对象是否等于当前对象。 (继承自 Object。)
受保护的方法Finalize释放 Socket 类使用的资源。 (重写 Object.Finalize()。)
公共方法GetHashCode作为默认哈希函数。 (继承自 Object。)
公共方法GetSocketOption(SocketOptionLevel, SocketOptionName)返回指定的 Socket 选项的值,表示为一个对象。
公共方法GetSocketOption(SocketOptionLevel, SocketOptionName,Byte[])返回指定的 Socket 选项设置,表示为字节数组。
公共方法GetSocketOption(SocketOptionLevel, SocketOptionName, Int32)返回数组中指定的 Socket 选项的值。
公共方法GetType获取当前实例的 Type。 (继承自 Object。)
公共方法IOControl(Int32, Byte[], Byte[])使用数字控制代码,为 Socket 设置低级操作模式。
公共方法IOControl(IOControlCode, Byte[], Byte[])使用 IOControlCode 枚举指定控制代码,为 Socket 设置低级操作模式。
公共方法Listen将 Socket 置于侦听状态。
受保护的方法MemberwiseClone创建当前 Object 的浅表副本。 (继承自 Object。)
公共方法Poll确定 Socket 的状态。
公共方法Receive(IList<ArraySegment<Byte>>)从绑定的 Socket 接收数据,将数据存入接收缓冲区列表中。
公共方法Receive(Byte[])从绑定的 Socket 套接字接收数据,将数据存入接收缓冲区。
公共方法Receive(IList<ArraySegment<Byte>>, SocketFlags)使用指定的 SocketFlags,从绑定的 Socket 接收数据,将数据存入接收缓冲区列表中。
公共方法Receive(Byte[], SocketFlags)使用指定的 SocketFlags,从绑定的 Socket 接收数据,将数据存入接收缓冲区。
公共方法Receive(IList<ArraySegment<Byte>>, SocketFlags, SocketError)使用指定的 SocketFlags,从绑定的 Socket 接收数据,将数据存入接收缓冲区列表中。
公共方法Receive(Byte[], Int32, SocketFlags)使用指定的 SocketFlags,从绑定的 Socket 接收指定字节数的数据,并将数据存入接收缓冲区。
公共方法Receive(Byte[], Int32, Int32, SocketFlags)使用指定的 SocketFlags,从绑定的 Socket 接收指定的字节数,存入接收缓冲区的指定偏移量位置。
公共方法Receive(Byte[], Int32, Int32, SocketFlags, SocketError)使用指定的 SocketFlags,从绑定的 Socket 接收数据,将数据存入接收缓冲区。
公共方法ReceiveAsync开始一个异步请求以便从连接的 Socket 对象中接收数据。
公共方法ReceiveFrom(Byte[], EndPoint)将数据报接收到数据缓冲区并存储终结点。
公共方法ReceiveFrom(Byte[], SocketFlags, EndPoint)使用指定的 SocketFlags 将数据报接收到数据缓冲区并存储终结点。
公共方法ReceiveFrom(Byte[], Int32, SocketFlags, EndPoint)使用指定的 SocketFlags 将指定的字节数接收到数据缓冲区并存储终结点。
公共方法ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)使用指定的 SocketFlags 将指定字节数的数据接收到数据缓冲区的指定位置并存储终结点。
公共方法ReceiveFromAsync开始从指定网络设备中异步接收数据。
公共方法ReceiveMessageFrom使用指定的 SocketFlags 将指定字节数的数据接收到数据缓冲区的指定位置,然后存储终结点和数据包信息。
公共方法ReceiveMessageFromAsync开始使用指定的 SocketAsyncEventArgs.SocketFlags 将指定字节数的数据异步接收到数据缓冲区的指定位置,并存储终结点和数据包信息。
公共方法静态成员Select确定一个或多个套接字的状态。
公共方法Send(IList<ArraySegment<Byte>>)将列表中的一组缓冲区发送到连接的 Socket。
公共方法Send(Byte[])将数据发送到连接的 Socket。
公共方法Send(IList<ArraySegment<Byte>>, SocketFlags)使用指定的 SocketFlags,将列表中的一组缓冲区发送到连接的Socket。
公共方法Send(Byte[], SocketFlags)使用指定的 SocketFlags 将数据发送到连接的 Socket。
公共方法Send(IList<ArraySegment<Byte>>, SocketFlags, SocketError)使用指定的 SocketFlags,将列表中的一组缓冲区发送到连接的Socket。
公共方法Send(Byte[], Int32, SocketFlags)使用指定的 SocketFlags,将指定字节数的数据发送到已连接的Socket。
公共方法Send(Byte[], Int32, Int32, SocketFlags)使用指定的 SocketFlags,将指定字节数的数据发送到已连接的Socket(从指定的偏移量开始)。
公共方法Send(Byte[], Int32, Int32, SocketFlags, SocketError)从指定的偏移量开始使用指定的 SocketFlags 将指定字节数的数据发送到连接的 Socket。
公共方法SendAsync将数据异步发送到连接的 Socket 对象。
公共方法SendFile(String)使用 UseDefaultWorkerThread 传输标志,将文件 fileName发送到连接的 Socket 对象。
公共方法SendFile(String, Byte[], Byte[], TransmitFileOptions)使用指定的 TransmitFileOptions 值,将文件 fileName 和数据缓冲区发送到连接的 Socket 对象。
公共方法SendPacketsAsync将文件集合或者内存中的数据缓冲区以异步方法发送给连接的Socket 对象。
公共方法SendTo(Byte[], EndPoint)将数据发送到指定的终结点。
公共方法SendTo(Byte[], SocketFlags, EndPoint)使用指定的 SocketFlags,将数据发送到特定的终结点。
公共方法SendTo(Byte[], Int32, SocketFlags, EndPoint)使用指定的 SocketFlags,将指定字节数的数据发送到指定的终结点。
公共方法SendTo(Byte[], Int32, Int32, SocketFlags, EndPoint)使用指定的 SocketFlags,将指定字节数的数据发送到指定终结点(从缓冲区中的指定位置开始)。
公共方法SendToAsync向特定远程主机异步发送数据。
公共方法SetIPProtectionLevel设置套接字的 IP 保护级别。
公共方法SetSocketOption(SocketOptionLevel, SocketOptionName, Boolean)将指定的 Socket 选项设置为指定的 Boolean 值。
公共方法SetSocketOption(SocketOptionLevel, SocketOptionName,Byte[])将指定的 Socket 选项设置为指定的值,表示为字节数组。
公共方法SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)将指定的 Socket 选项设置为指定的整数值。
公共方法SetSocketOption(SocketOptionLevel, SocketOptionName, Object)将指定的 Socket 选项设置为指定值,表示为对象。
公共方法Shutdown禁用某 Socket 上的发送和接收。
公共方法ToString返回表示当前对象的字符串。 (继承自 Object。)
页首

备注

 

Socket 类为网络通信提供了一套丰富的方法和属性。 Socket 类允许您使用 ProtocolType 枚举中所列出的任何一种协议执行异步和同步数据传输。

Socket 类对异步方法遵循 .NET Framework 命名模式。 例如,同步的 Receive 方法对应于异步的 BeginReceive 和 EndReceive 方法。

如果应用程序在执行期间只需要一个线程,请使用下面的方法,这些方法适用于同步操作模式。

  • 如果当前使用的是面向连接的协议(如 TCP),则服务器可以使用 Listen 方法侦听连接。 Accept 方法处理任何传入的连接请求,并返回可用于与远程主机进行数据通信的 Socket。 可以使用此返回的 Socket 来调用 Send 或 Receive 方法。 如果要指定本地 IP 地址和端口号,请在调用 Listen 方法之前先调用 Bind 方法。 如果您希望基础服务提供程序为您分配可用端口,请使用端口号 0。 如果希望连接到侦听主机,请调用 Connect 方法。 若要进行数据通信,请调用 Send 或 Receive 方法。

  • 如果当前使用的是无连接协议(如 UDP),则根本不需要侦听连接。 调用 ReceiveFrom 方法可接受任何传入的数据报。 使用 SendTo 方法可将数据报发送到远程主机。

若要在执行过程中使用单独的线程处理通信,请使用下面的方法,这些方法适用于异步操作模式。

如果对一个套接字执行多个异步操作,它们不一定按启动时的顺序完成。

当数据发送和数据接收完成之后,可使用 Shutdown 方法来禁用 Socket。 在调用 Shutdown 之后,可调用 Close 方法来释放与 Socket 关联的所有资源。

通过 Socket 类,您可以使用 SetSocketOption 方法来配置 Socket。 可以使用 GetSocketOption 方法来检索这些设置。

说明说明

如果要编写相对简单的应用程序,而且不需要最高的性能,则可以考虑使用 TcpClientTcpListener 和 UdpClient。 这些类为 Socket 通信提供了更简单、对用户更友好的接口。

示例

 

下面的代码示例演示如何使用 Socket 类向 HTTP 服务器发送数据和接收响应。 接收到整个页前,此示例将一直处于阻止状态。

C#
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);
    }
}
 

此类的实例是线程安全的。

转载于:https://www.cnblogs.com/hongmaju/p/4736246.html

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值