Socket.SendFileAsync Метод

Определение

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

System.Net.Sockets

Сборки:

netstandard.dll, System.Net.Sockets.dll

Перегрузки

Имя	Описание
SendFileAsync(String, CancellationToken)	Отправляет файл fileName в подключенный Socket объект.
SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken)	Отправляет файл fileName и буферы данных в подключенный Socket объект с помощью указанного TransmitFileOptions значения.

SendFileAsync(String, CancellationToken)

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

Socket.Tasks.cs

Отправляет файл fileName в подключенный Socket объект.

public System.Threading.Tasks.ValueTask SendFileAsync(string? fileName, System.Threading.CancellationToken cancellationToken = default);

member this.SendFileAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function SendFileAsync (fileName As String, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Параметры

fileName

String

Объект, String содержащий путь и имя отправленного файла. Этот параметр может иметь значение null.

cancellationToken

CancellationToken

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

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

ValueTask

Задача значения, представляющая асинхронную операцию отправки файла.

Исключения

ObjectDisposedException

Объект Socket закрыт.

NotSupportedException

Объект Socket не подключен к удаленному узлу.

FileNotFoundException

Файл fileName не найден.

SocketException

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

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых SendFile(String).

SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken)

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

Socket.Tasks.cs

Отправляет файл fileName и буферы данных в подключенный Socket объект с помощью указанного TransmitFileOptions значения.

public System.Threading.Tasks.ValueTask SendFileAsync(string? fileName, ReadOnlyMemory<byte> preBuffer, ReadOnlyMemory<byte> postBuffer, System.Net.Sockets.TransmitFileOptions flags, System.Threading.CancellationToken cancellationToken = default);

member this.SendFileAsync : string * ReadOnlyMemory<byte> * ReadOnlyMemory<byte> * System.Net.Sockets.TransmitFileOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function SendFileAsync (fileName As String, preBuffer As ReadOnlyMemory(Of Byte), postBuffer As ReadOnlyMemory(Of Byte), flags As TransmitFileOptions, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Параметры

fileName

String

Объект, String содержащий путь и имя отправленного файла. Этот параметр может иметь значение null.

preBuffer

ReadOnlyMemory<Byte>

Byte Массив, содержащий данные, отправляемые перед отправкой файла. Этот параметр может иметь значение null.

postBuffer

ReadOnlyMemory<Byte>

Byte Массив, содержащий данные, отправляемые после отправки файла. Этот параметр может иметь значение null.

flags

TransmitFileOptions

Одно или несколько значений TransmitFileOptions .

cancellationToken

CancellationToken

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

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

ValueTask

Задача значения, представляющая асинхронную операцию отправки файла.

Исключения

ObjectDisposedException

Объект Socket закрыт.

NotSupportedException

Объект Socket не подключен к удаленному узлу.

FileNotFoundException

Файл fileName не найден.

SocketException

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

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.