Socket.SendFileAsync 方法

参考

定义

命名空间:: System.Net.Sockets

程序集:: System.Net.Sockets.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

SendFileAsync(String, CancellationToken)	将文件 `fileName` 发送到连接的 Socket 对象。
SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken)	通过指定的 TransmitFileOptions 值，将文件 `fileName` 和数据缓冲区发送到连接的 Socket 对象。

SendFileAsync(String, CancellationToken)

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

可用于取消异步操作的取消标记。

ValueTask

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

例外

ObjectDisposedException

Socket 对象已关闭。

NotSupportedException

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

FileNotFoundException

未找到文件 fileName。

SocketException

尝试访问套接字时出错。

OperationCanceledException

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

注解

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

适用于

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

Source:: Socket.Tasks.cs

Source:: Socket.Tasks.cs

Source:: Socket.Tasks.cs

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

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