Socket.SendFileAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przeciążenia
SendFileAsync(String, CancellationToken) |
Wysyła plik |
SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken) |
Wysyła plik |
SendFileAsync(String, CancellationToken)
- Źródło:
- Socket.Tasks.cs
- Źródło:
- Socket.Tasks.cs
- Źródło:
- Socket.Tasks.cs
Wysyła plik fileName
do połączonego Socket obiektu.
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
Parametry
- fileName
- String
Element String zawierający ścieżkę i nazwę pliku do wysłania. Ten parametr może mieć wartość null
.
- cancellationToken
- CancellationToken
Token anulowania, który może służyć do anulowania operacji asynchronicznej.
Zwraca
Zadanie wartości reprezentujące asynchroniczną operację wysyłania pliku.
Wyjątki
Obiekt Socket został zamknięty.
Obiekt Socket nie jest połączony z hostem zdalnym.
Nie można odnaleźć pliku fileName
.
Wystąpił błąd podczas próby uzyskania dostępu do gniazda.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Uwagi
Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez SendFile(String)usługę .
Dotyczy
SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken)
- Źródło:
- Socket.Tasks.cs
- Źródło:
- Socket.Tasks.cs
- Źródło:
- Socket.Tasks.cs
Wysyła plik fileName
i bufory danych do połączonego Socket obiektu przy użyciu określonej TransmitFileOptions wartości.
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
Parametry
- fileName
- String
Element String zawierający ścieżkę i nazwę pliku do wysłania. Ten parametr może mieć wartość null
.
- preBuffer
- ReadOnlyMemory<Byte>
Tablica zawierająca Byte dane do wysłania przed wysłaniem pliku. Ten parametr może mieć wartość null
.
- postBuffer
- ReadOnlyMemory<Byte>
Tablica zawierająca Byte dane do wysłania po wysłaniu pliku. Ten parametr może mieć wartość null
.
- flags
- TransmitFileOptions
Co najmniej jedna wartość TransmitFileOptions .
- cancellationToken
- CancellationToken
Token anulowania, który może służyć do anulowania operacji asynchronicznej.
Zwraca
Zadanie wartości reprezentujące asynchroniczną operację wysyłania pliku.
Wyjątki
Obiekt Socket został zamknięty.
Obiekt Socket nie jest połączony z hostem zdalnym.
Nie można odnaleźć pliku fileName
.
Wystąpił błąd podczas próby uzyskania dostępu do gniazda.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.