Socket.SendFileAsync 方法

定義

命名空間:: System.Net.Sockets

組件:: netstandard.dll, System.Net.Sockets.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
SendFileAsync(String, CancellationToken)	將檔案 `fileName` 傳送到連接 Socket 物件。
SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken)	將檔案`fileName`和資料緩衝區以指定的Socket值傳送給連接TransmitFileOptions的物件。

SendFileAsync(String, CancellationToken)

來源:: Socket.Tasks.cs

來源:: Socket.Tasks.cs

來源:: Socket.Tasks.cs

來源:: Socket.Tasks.cs

來源:: 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 A 包含要傳送檔案的路徑與名稱。這個參數可以是 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

來源:: Socket.Tasks.cs

來源:: Socket.Tasks.cs

來源:: Socket.Tasks.cs

來源:: 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