共用方式為


Socket.SendFileAsync 方法

定義

多載

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

可用來取消異步操作的取消標記。

傳回

值工作,表示異步傳送檔案作業。

例外狀況

Socket物件已關閉。

物件 Socket 未連線到遠端主機。

找不到檔案 fileName

嘗試存取通訊端時發生錯誤。

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

備註

這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用狀況例外狀況,例如 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

參數

fileName
String

包含要傳送之檔案的路徑與名稱的 String。 這個參數可以是 null

preBuffer
ReadOnlyMemory<Byte>

包含傳送檔案前要傳送之資料的 Byte 陣列。 這個參數可以是 null

postBuffer
ReadOnlyMemory<Byte>

包含傳送檔案後要傳送之資料的 Byte 陣列。 這個參數可以是 null

flags
TransmitFileOptions

一或多個 TransmitFileOptions 值。

cancellationToken
CancellationToken

可用來取消異步操作的取消標記。

傳回

值工作,表示異步傳送檔案作業。

例外狀況

Socket物件已關閉。

物件 Socket 未連線到遠端主機。

找不到檔案 fileName

嘗試存取通訊端時發生錯誤。

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

適用於