Socket.SendFileAsync Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Overload

SendFileAsync(String, CancellationToken)	Invia il file fileName a un oggetto connesso Socket .
SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken)	Invia il file fileName e i buffer di dati a un oggetto Socket connesso usando il valore di TransmitFileOptions specificato.

SendFileAsync(String, CancellationToken)

Origine:

Socket.Tasks.cs

Invia il file fileName a un oggetto connesso 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

Parametri

fileName

String

Oggetto String che contiene il percorso e il nome del file da inviare. Questo parametro può essere null.

cancellationToken

CancellationToken

Token di annullamento che può essere utilizzato per annullare l'operazione asincrona.

Restituisce

ValueTask

Attività valore che rappresenta l'operazione di invio asincrona del file.

Eccezioni

ObjectDisposedException

L'oggetto Socket è stato chiuso.

NotSupportedException

L'oggetto Socket non è connesso a un host remoto.

FileNotFoundException

Il parametro fileName del file non è stato trovato.

SocketException

Si è verificato un errore durante il tentativo di accesso al socket.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da SendFile(String).

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

Origine:

Socket.Tasks.cs

Invia il file fileName e i buffer di dati a un oggetto Socket connesso usando il valore di TransmitFileOptions specificato.

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

Parametri

fileName

String

Oggetto String che contiene il percorso e il nome del file da inviare. Questo parametro può essere null.

preBuffer

ReadOnlyMemory<Byte>

Oggetto matrice Byte che contiene i dati da inviare prima dell'invio del file. Questo parametro può essere null.

postBuffer

ReadOnlyMemory<Byte>

Oggetto matrice Byte che contiene i dati da inviare dopo l'invio del file. Questo parametro può essere null.

flags

TransmitFileOptions

Uno o più valori di TransmitFileOptions.

cancellationToken

CancellationToken

Token di annullamento che può essere utilizzato per annullare l'operazione asincrona.

Restituisce

ValueTask

Attività valore che rappresenta l'operazione di invio asincrona del file.

Eccezioni

ObjectDisposedException

L'oggetto Socket è stato chiuso.

NotSupportedException

L'oggetto Socket non è connesso a un host remoto.

FileNotFoundException

Il parametro fileName del file non è stato trovato.

SocketException

Si è verificato un errore durante il tentativo di accesso al socket.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.