Socket.IOControl Метод

Определение

Пространство имен:

System.Net.Sockets

Сборка:

System.Net.Sockets.dll

Задает низкоуровневые операционные режимы для объекта Socket.

Перегрузки

IOControl(Int32, Byte[], Byte[])	Задает низкоуровневые операционные режимы для объекта Socket, используя цифровые коды элементов управления.
IOControl(IOControlCode, Byte[], Byte[])	Задает низкоуровневые операционные режимы для объекта Socket, используя перечисление IOControlCode, чтобы указать коды элементов управления.

IOControl(Int32, Byte[], Byte[])

Исходный код:

Socket.cs

Задает низкоуровневые операционные режимы для объекта Socket, используя цифровые коды элементов управления.

public:
 int IOControl(int ioControlCode, cli::array <System::Byte> ^ optionInValue, cli::array <System::Byte> ^ optionOutValue);

public int IOControl (int ioControlCode, byte[]? optionInValue, byte[]? optionOutValue);

member this.IOControl : int * byte[] * byte[] -> int

Public Function IOControl (ioControlCode As Integer, optionInValue As Byte(), optionOutValue As Byte()) As Integer

Параметры

ioControlCode

Int32

Значение Int32, задающее код элемента управления для выполняемой операции.

optionInValue

Byte[]

Массив Byte, который содержит входные данные, необходимые для операции.

optionOutValue

Byte[]

Массив Byte, который содержит выходные данные, необходимые для операции.

Возвращаемое значение

Int32

Число байтов в параметре optionOutValue.

Исключения

SocketException

Произошла ошибка при попытке доступа к сокету.

ObjectDisposedException

Socket был закрыт.

InvalidOperationException

Была сделана попытка изменения блокирующего режима без использования свойства Blocking.

SecurityException

Вызывающий оператор в стеке вызовов не имеет необходимых разрешений.

Примеры

В следующем примере кода сравниваются результаты FIONREAD и свойство Available.

// FIONREAD is also available as the "Available" property.
const int FIONREAD = 0x4004667F;

void DisplayPendingByteCount( Socket^ s )
{
   array<Byte>^ outValue = BitConverter::GetBytes( 0 );
   
   // Check how many bytes have been received.
   s->IOControl( FIONREAD, nullptr, outValue );

   UInt32 bytesAvailable = BitConverter::ToUInt32( outValue, 0 );
   Console::WriteLine( "server has {0} bytes pending. Available property says {1}.",
      bytesAvailable, s->Available );

   return;
}

 // FIONREAD is also available as the "Available" property.
public const int FIONREAD   = 0x4004667F;

static void DisplayPendingByteCount(Socket s)
 {
     byte[] outValue = BitConverter.GetBytes(0);

     // Check how many bytes have been received.
     s.IOControl(FIONREAD, null, outValue);

     uint bytesAvailable = BitConverter.ToUInt32(outValue, 0);
     Console.WriteLine("server has {0} bytes pending. Available property says {1}.",
         bytesAvailable, s.Available);

     return;
 }

Комментарии

Метод IOControl обеспечивает низкоуровневый доступ к операционной системе Socket , лежащей в основе текущего экземпляра Socket класса . Дополнительные сведения см. в документации по WSAIoctl .

Примечание

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

Примечание

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

IOControl(IOControlCode, Byte[], Byte[])

Исходный код:

Socket.cs

Задает низкоуровневые операционные режимы для объекта Socket, используя перечисление IOControlCode, чтобы указать коды элементов управления.

public:
 int IOControl(System::Net::Sockets::IOControlCode ioControlCode, cli::array <System::Byte> ^ optionInValue, cli::array <System::Byte> ^ optionOutValue);

public int IOControl (System.Net.Sockets.IOControlCode ioControlCode, byte[]? optionInValue, byte[]? optionOutValue);

member this.IOControl : System.Net.Sockets.IOControlCode * byte[] * byte[] -> int

Public Function IOControl (ioControlCode As IOControlCode, optionInValue As Byte(), optionOutValue As Byte()) As Integer

Параметры

ioControlCode

IOControlCode

Значение IOControlCode, задающее код элемента управления для выполняемой операции.

optionInValue

Byte[]

Массив типа Byte, который содержит входные данные, необходимые для операции.

optionOutValue

Byte[]

Массив типа Byte, который содержит выходные данные, возвращенные операцией.

Возвращаемое значение

Int32

Число байтов в параметре optionOutValue.

Исключения

SocketException

Произошла ошибка при попытке доступа к сокету.

ObjectDisposedException

Socket был закрыт.

InvalidOperationException

Была сделана попытка изменения блокирующего режима без использования свойства Blocking.

Примеры

В следующем примере кода сравниваются результаты вызова IOControl со DataToRead свойством Available и .

void DisplayPendingByteCount( Socket^ s )
{
   array<Byte>^ outValue = BitConverter::GetBytes( 0 );
   
   // Check how many bytes have been received.
   s->IOControl( IOControlCode::DataToRead, nullptr, outValue );

   UInt32 bytesAvailable = BitConverter::ToUInt32( outValue, 0 );
   Console::Write( "server has {0} bytes pending,",
      bytesAvailable );
   Console::WriteLine( "Available property says {1}.",
      s->Available );
   return;
}

static void DisplayPendingByteCount(Socket s)
{
    byte[] outValue = BitConverter.GetBytes(0);

    // Check how many bytes have been received.
    s.IOControl(IOControlCode.DataToRead, null, outValue);

    uint bytesAvailable = BitConverter.ToUInt32(outValue, 0);
    Console.Write("server has {0} bytes pending. ",
        bytesAvailable);
    Console.WriteLine("Available property says {1}.",
                     s.Available);

    return;
}

Комментарии

Этот метод обеспечивает низкоуровневый доступ к операционной системе Socket , лежащей в основе текущего экземпляра Socket класса . Дополнительные сведения см. в документации по WSAIoctl .

Примечание

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

Примечание

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