Прочитать на английском

Поделиться через


Socket Конструкторы

Определение

Инициализирует новый экземпляр класса Socket.

Перегрузки

Socket(SafeSocketHandle)

Инициализирует новый экземпляр Socket класса для указанного дескриптора сокета.

Socket(SocketInformation)

Инициализирует новый экземпляр класса Socket с помощью указанного значения, возвращенного из объекта DuplicateAndClose(Int32).

Socket(SocketType, ProtocolType)

Инициализирует новый экземпляр класса Socket, используя указанный тип сокетов и протокол. Если операционная система поддерживает протокол IPv6, этот конструктор создает сокет с двумя режимами; в противном случае создается сокет IPv4.

Socket(AddressFamily, SocketType, ProtocolType)

Инициализирует новый экземпляр класса Socket, используя заданные семейство адресов, тип сокета и протокол.

Socket(SafeSocketHandle)

Исходный код:
Socket.cs
Исходный код:
Socket.cs
Исходный код:
Socket.cs

Инициализирует новый экземпляр Socket класса для указанного дескриптора сокета.

public Socket(System.Net.Sockets.SafeSocketHandle handle);

Параметры

handle
SafeSocketHandle

Дескриптор сокета для сокета, который будет инкапсулирован с помощью объекта Socket.

Исключения

handle имеет значение null.

handle недопустим.

handle не является сокетом или не удалось получить доступ к сведениям о сокете.

Комментарии

Этот метод заполняет экземпляр данными Socket , собранными из предоставленного SafeSocketHandle. Различные операционные системы обеспечивают различные уровни поддержки запросов к дескрипторов сокета или дескриптора файла для его свойств и конфигурации. Некоторые общедоступные API в результирующем Socket экземпляре могут отличаться в зависимости от операционной системы, например ProtocolType и Blocking.

Применяется к

.NET 10 и другие версии
Продукт Версии
.NET 5, 6, 7, 8, 9, 10

Socket(SocketInformation)

Исходный код:
Socket.cs
Исходный код:
Socket.cs
Исходный код:
Socket.cs

Инициализирует новый экземпляр класса Socket с помощью указанного значения, возвращенного из объекта DuplicateAndClose(Int32).

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public Socket(System.Net.Sockets.SocketInformation socketInformation);
public Socket(System.Net.Sockets.SocketInformation socketInformation);

Параметры

socketInformation
SocketInformation

Информация сокета, возвращенная объектом DuplicateAndClose(Int32).

Атрибуты

Комментарии

Если вы вызываете Socket конструктор несколько раз с тем же массивом байтов, что и аргумент для каждого вызова, вы создадите несколько управляемых Socketобъектов с тем же базовым сокетом. Такая практика настоятельно не рекомендуется.

Применяется к

.NET 10 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Socket(SocketType, ProtocolType)

Исходный код:
Socket.cs
Исходный код:
Socket.cs
Исходный код:
Socket.cs

Инициализирует новый экземпляр класса Socket, используя указанный тип сокетов и протокол. Если операционная система поддерживает протокол IPv6, этот конструктор создает сокет с двумя режимами; в противном случае создается сокет IPv4.

public Socket(System.Net.Sockets.SocketType socketType, System.Net.Sockets.ProtocolType protocolType);

Параметры

socketType
SocketType

Одно из значений перечисления SocketType.

protocolType
ProtocolType

Одно из значений перечисления ProtocolType.

Исключения

Сочетание socketType и protocolType приводит к недопустимому сокету.

Комментарии

Параметр socketType указывает тип класса , Socket а protocolType параметр — протокол, используемый Socket. Эти два параметра не являются независимыми. Socket Часто тип является неявным в протоколе. Если сочетание Socket типа и типа протокола приводит к недопустимому Socketзначению , этот конструктор создает исключение SocketException.

Примечание

Если этот конструктор создает SocketExceptionисключение , используйте SocketException.ErrorCode свойство для получения определенного кода ошибки. Получив этот код, ознакомьтесь с документацией по коду ошибки API сокетов Windows версии 2 , чтобы получить подробное описание ошибки.

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.

Применяется к

.NET 10 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Socket(AddressFamily, SocketType, ProtocolType)

Исходный код:
Socket.cs
Исходный код:
Socket.cs
Исходный код:
Socket.cs

Инициализирует новый экземпляр класса Socket, используя заданные семейство адресов, тип сокета и протокол.

public Socket(System.Net.Sockets.AddressFamily addressFamily, System.Net.Sockets.SocketType socketType, System.Net.Sockets.ProtocolType protocolType);

Параметры

addressFamily
AddressFamily

Одно из значений перечисления AddressFamily.

socketType
SocketType

Одно из значений перечисления SocketType.

protocolType
ProtocolType

Одно из значений перечисления ProtocolType.

Исключения

Сочетание параметров addressFamily, socketType и protocolType приводит к неработоспособному сокету.

Примеры

В следующем примере кода показано, как создать экземпляр Socket класса .

using System;
using System.Text;
using System.IO;
using System.Net;
using System.Net.Sockets;

public class Sample
{

  public static string DoSocketGet(string server)
  {
    //Set up variables and String to write to the server.
    Encoding ASCII = Encoding.ASCII;
    string Get = "GET / HTTP/1.1\r\nHost: " + server +
                 "\r\nConnection: Close\r\n\r\n";
    Byte[] ByteGet = ASCII.GetBytes(Get);
    Byte[] RecvBytes = new Byte[256];
    String strRetPage = null;

    // IPAddress and IPEndPoint represent the endpoint that will
    //   receive the request.
    // Get first IPAddress in list return by DNS.

    try
    {

      // Define those variables to be evaluated in the next for loop and
      // then used to connect to the server. These variables are defined
      // outside the for loop to make them accessible there after.
      Socket s = null;
      IPEndPoint hostEndPoint;
      IPAddress hostAddress = null;
      int conPort = 80;

      // Get DNS host information.
      IPHostEntry hostInfo = Dns.GetHostEntry(server);
      // Get the DNS IP addresses associated with the host.
      IPAddress[] IPaddresses = hostInfo.AddressList;

      // Evaluate the socket and receiving host IPAddress and IPEndPoint.
      for (int index=0; index<IPaddresses.Length; index++)
      {
        hostAddress = IPaddresses[index];
        hostEndPoint = new IPEndPoint(hostAddress, conPort);


        // Creates the Socket to send data over a TCP connection.
        s = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp );


        // Connect to the host using its IPEndPoint.
        s.Connect(hostEndPoint);

        if (!s.Connected)
        {
          // Connection failed, try next IPaddress.
          strRetPage = "Unable to connect to host";
          s = null;
          continue;
        }

        // Sent the GET request to the host.
        s.Send(ByteGet, ByteGet.Length, 0);

      } // End of the for loop.


      // Receive the host home page content and loop until all the data is received.
      Int32 bytes = s.Receive(RecvBytes, RecvBytes.Length, 0);
      strRetPage = "Default HTML page on " + server + ":\r\n";
      strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes);

      while (bytes > 0)
      {
        bytes = s.Receive(RecvBytes, RecvBytes.Length, 0);
        strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes);
      }

    } // End of the try block.

    catch(SocketException e)
    {
      Console.WriteLine("SocketException caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }
    catch(ArgumentNullException e)
    {
      Console.WriteLine("ArgumentNullException caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }
    catch(NullReferenceException e)
    {
      Console.WriteLine("NullReferenceException caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }
    catch(Exception e)
    {
      Console.WriteLine("Exception caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }

    return strRetPage;
}
   public static void Main()
   {
      Console.WriteLine(DoSocketGet("localhost"));
   }
 }

Комментарии

Параметр addressFamily указывает схему адресации, используемую Socket классомSocket, socketType параметр указывает тип Socket класса, а protocolType параметр указывает протокол, используемый . Три параметра не являются независимыми. Некоторые семейства адресов ограничивают, какие протоколы можно использовать с ними, и часто Socket тип является неявным в протоколе. Если сочетание семейства адресов, Socket типа и типа протокола приводит к недопустимому Socketзначению , этот конструктор создает исключение SocketException.

Примечание

Если этот конструктор создает SocketExceptionисключение , используйте SocketException.ErrorCode свойство для получения определенного кода ошибки. Получив этот код, ознакомьтесь с документацией по коду ошибки API сокетов Windows версии 2 , чтобы получить подробное описание ошибки.

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.

См. также раздел

Применяется к

.NET 10 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0