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)

來源:: 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。這個參數可以是 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

使用指定的 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