다음을 통해 공유


Socket.SendFileAsync 메서드

정의

오버로드

SendFileAsync(String, CancellationToken)

파일을 fileName 연결된 Socket 개체로 보냅니다.

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

지정된 TransmitFileOptions 값을 사용하여 연결된 Socket 개체에 파일 fileName 및 데이터 버퍼를 전송합니다.

SendFileAsync(String, CancellationToken)

Source:
Socket.Tasks.cs
Source:
Socket.Tasks.cs
Source:
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 파일을 찾을 수 없는 경우

소켓에 액세스하는 동안 오류가 발생했습니다.

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw SendFile(String)된 예외를 참조하세요.

적용 대상

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

Source:
Socket.Tasks.cs
Source:
Socket.Tasks.cs
Source:
Socket.Tasks.cs

지정된 TransmitFileOptions 값을 사용하여 연결된 Socket 개체에 파일 fileName 및 데이터 버퍼를 전송합니다.

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 파일을 찾을 수 없는 경우

소켓에 액세스하는 동안 오류가 발생했습니다.

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

적용 대상