Socket.SendFileAsync Method

Reference

Definition

Namespace:: System.Net.Sockets

Assembly:: System.Net.Sockets.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Overloads

SendFileAsync(String, CancellationToken)	Sends the file `fileName` to a connected Socket object.
SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken)	Sends the file `fileName` and buffers of data to a connected Socket object using the specified TransmitFileOptions value.

SendFileAsync(String, CancellationToken)

Source:: Socket.Tasks.cs

Source:: Socket.Tasks.cs

Source:: Socket.Tasks.cs

Sends the file fileName to a connected Socket object.

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

Parameters

fileName: String

A String that contains the path and name of the file to be sent. This parameter can be null.

cancellationToken: CancellationToken

A cancellation token that can be used to cancel the asynchronous operation.

Returns

ValueTask

A value task that represents the asynchronous send file operation.

Exceptions

ObjectDisposedException

The Socket object has been closed.

NotSupportedException

The Socket object is not connected to a remote host.

FileNotFoundException

The file fileName was not found.

SocketException

An error occurred when attempting to access the socket.

OperationCanceledException

The cancellation token was canceled. This exception is stored into the returned task.

Remarks

This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as ArgumentException, are still thrown synchronously. For the stored exceptions, see the exceptions thrown by SendFile(String).

Applies to

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

Source:: Socket.Tasks.cs

Source:: Socket.Tasks.cs

Source:: Socket.Tasks.cs

Sends the file fileName and buffers of data to a connected Socket object using the specified TransmitFileOptions value.

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