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

尝试访问套接字时出错。

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

适用于