Socket.SendFileAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
SendFileAsync(String, CancellationToken) |
Mengirim file |
SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken) |
Mengirim file |
SendFileAsync(String, CancellationToken)
- Sumber:
- Socket.Tasks.cs
- Sumber:
- Socket.Tasks.cs
- Sumber:
- Socket.Tasks.cs
Mengirim file fileName
ke objek yang tersambung 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
Parameter
- fileName
- String
yang String berisi jalur dan nama file yang akan dikirim. Parameter ini dapat berupa null
.
- cancellationToken
- CancellationToken
Token pembatalan yang dapat digunakan untuk membatalkan operasi asinkron.
Mengembalikan
Tugas nilai yang mewakili operasi kirim file asinkron.
Pengecualian
Objek Socket telah ditutup.
Objek Socket tidak tersambung ke host jarak jauh.
File fileName
tidak ditemukan.
Terjadi kesalahan saat mencoba mengakses soket.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh SendFile(String).
Berlaku untuk
SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken)
- Sumber:
- Socket.Tasks.cs
- Sumber:
- Socket.Tasks.cs
- Sumber:
- Socket.Tasks.cs
Mengirim file fileName
dan buffer data ke objek yang tersambung Socket menggunakan nilai yang ditentukan TransmitFileOptions .
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
Parameter
- fileName
- String
yang String berisi jalur dan nama file yang akan dikirim. Parameter ini dapat berupa null
.
- preBuffer
- ReadOnlyMemory<Byte>
Array Byte yang berisi data yang akan dikirim sebelum file dikirim. Parameter ini dapat berupa null
.
- postBuffer
- ReadOnlyMemory<Byte>
Array Byte yang berisi data yang akan dikirim setelah file dikirim. Parameter ini dapat berupa null
.
- flags
- TransmitFileOptions
Satu atau beberapa TransmitFileOptions nilai.
- cancellationToken
- CancellationToken
Token pembatalan yang dapat digunakan untuk membatalkan operasi asinkron.
Mengembalikan
Tugas nilai yang mewakili operasi kirim file asinkron.
Pengecualian
Objek Socket telah ditutup.
Objek Socket tidak tersambung ke host jarak jauh.
File fileName
tidak ditemukan.
Terjadi kesalahan saat mencoba mengakses soket.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.