语言

Socket.SendFileAsync 方法

定义

重载

名称 说明
SendFileAsync(String, CancellationToken)

将文件 fileName 发送到连接的 Socket 对象。

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

使用指定的fileName值将数据文件和Socket缓冲区发送到连接的TransmitFileOptions对象。

SendFileAsync(String, CancellationToken)

Source:
Socket.Tasks.cs
Source:
Socket.Tasks.cs
Source:
Socket.Tasks.cs
Source:
Socket.Tasks.cs
Source:
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

可用于取消异步作的取消令牌。

返回

一个表示异步发送文件操作的值任务。

例外

对象 Socket 已关闭。

对象 Socket 未连接到远程主机。

找不到该文件 fileName 。

尝试访问套接字时出错。

取消令牌已取消。 此异常存储在返回的任务中。

注解

此方法存储在任务中,它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中,则等待任务时将引发该异常。 使用情况异常(例如 ArgumentException)仍会同步引发。 有关存储的异常,请参阅由 SendFile(String)..

适用于

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

Source:
Socket.Tasks.cs
Source:
Socket.Tasks.cs
Source:
Socket.Tasks.cs
Source:
Socket.Tasks.cs
Source:
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

可用于取消异步作的取消令牌。

返回

一个表示异步发送文件操作的值任务。

例外

对象 Socket 已关闭。

对象 Socket 未连接到远程主机。

找不到该文件 fileName 。

尝试访问套接字时出错。

取消令牌已取消。 此异常存储在返回的任务中。

适用于