Socket.SendFileAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| SendFileAsync(String, CancellationToken) |
将文件 |
| SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken) |
使用指定的 |
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
参数
- 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
参数
- preBuffer
- ReadOnlyMemory<Byte>
一个 Byte 数组,其中包含在发送文件之前要发送的数据。 此参数可以为 null。
- postBuffer
- ReadOnlyMemory<Byte>
一个 Byte 数组,其中包含在发送文件后要发送的数据。 此参数可以为 null。
- flags
- TransmitFileOptions
一个或多个 TransmitFileOptions 值。
- cancellationToken
- CancellationToken
可用于取消异步作的取消令牌。
返回
一个表示异步发送文件操作的值任务。
例外
对象 Socket 已关闭。
对象 Socket 未连接到远程主机。
找不到该文件 fileName 。
尝试访问套接字时出错。
取消令牌已取消。 此异常存储在返回的任务中。