Socket.BeginSendFile 메서드

Source:

Socket.cs

Source:

Socket.cs

Source:

Socket.cs

public:
 IAsyncResult ^ BeginSendFile(System::String ^ fileName, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginSendFile (string fileName, AsyncCallback? callback, object? state);

public IAsyncResult BeginSendFile (string? fileName, AsyncCallback? callback, object? state);

public IAsyncResult BeginSendFile (string fileName, AsyncCallback callback, object state);

member this.BeginSendFile : string * AsyncCallback * obj -> IAsyncResult

Public Function BeginSendFile (fileName As String, callback As AsyncCallback, state As Object) As IAsyncResult

매개 변수

반환

비동기 보내기를 나타내는 IAsyncResult 개체입니다.

예외

설명

이 오버로드는 소켓을 통해 파일을 fileName 보냅니다. 가 로컬 디렉터리에 있는 경우 fileName 파일 이름만으로 식별될 수 있습니다. 그렇지 않으면 파일의 전체 경로와 이름을 지정해야 합니다. 와일드카드(".. \\myfile.txt") 및 UNC 공유 이름("\\\\shared directory\\myfile.txt")이 지원됩니다. 파일을 찾을 수 없으면 예외 FileNotFoundException 가 throw됩니다.

를 구현하는 콜백을 AsyncCallbackBeginSendFile 전달하여 작업 완료에 대한 알림을 받을 수 있습니다. 기본 네트워크 스택이 동기적으로 작업을 완료하는 경우 콜백은 를 호출 BeginSendFile하는 동안 인라인으로 실행됩니다. 이 경우 반환 IAsyncResult 된 의 CompletedSynchronously 속성이 로 설정 true 되어 메서드가 동기적으로 완료되었음을 나타냅니다. 사용 하 여는 의 AsyncStateIAsyncResult 속성을 메서드에 전달 된 상태 개체를 BeginSendFile 가져옵니다.

메서드를 BeginSendFile 호출 EndSendFile 하여 작업을 완료해야 합니다. 일반적으로 메서드는 대리자에서 호출됩니다 AsyncCallback . EndSendFile 는 작업이 완료될 때까지 호출 스레드를 차단합니다.

연결 지향 프로토콜을 위한 것이지만, BeginSendFile 또는 BeginConnect 메서드를 먼저 호출 Connect 하여 기본 원격 호스트를 설정하는 경우 연결 없는 프로토콜에서도 작동합니다. 연결이 없는 프로토콜을 사용하면 파일 크기가 기본 서비스 공급자의 최대 패킷 크기를 초과하지 않는지 확인해야 합니다. 이 경우 데이터그램이 전송 BeginSendFile 되지 않고 예외가 SocketException throw됩니다.

Source:

Socket.cs

Source:

Socket.cs

Source:

Socket.cs

public:
 IAsyncResult ^ BeginSendFile(System::String ^ fileName, cli::array <System::Byte> ^ preBuffer, cli::array <System::Byte> ^ postBuffer, System::Net::Sockets::TransmitFileOptions flags, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginSendFile (string? fileName, byte[]? preBuffer, byte[]? postBuffer, System.Net.Sockets.TransmitFileOptions flags, AsyncCallback? callback, object? state);

public IAsyncResult BeginSendFile (string fileName, byte[] preBuffer, byte[] postBuffer, System.Net.Sockets.TransmitFileOptions flags, AsyncCallback callback, object state);

member this.BeginSendFile : string * byte[] * byte[] * System.Net.Sockets.TransmitFileOptions * AsyncCallback * obj -> IAsyncResult

Public Function BeginSendFile (fileName As String, preBuffer As Byte(), postBuffer As Byte(), flags As TransmitFileOptions, callback As AsyncCallback, state As Object) As IAsyncResult

매개 변수

반환

비동기 작업을 나타내는 IAsyncResult 개체입니다.

예외

설명

이 오버로드에는 보낼 파일의 이름과 값의 TransmitFileOptions 비트 조합이 필요합니다. 매개 변수에는 preBuffer 파일 앞에 하려는 모든 데이터가 포함됩니다. postBuffer 에는 파일을 따르려는 데이터가 포함되어 있습니다. 가 로컬 디렉터리에 있는 경우 fileName 파일 이름만으로 식별될 수 있습니다. 그렇지 않으면 파일의 전체 경로와 이름을 지정해야 합니다. 와일드카드(".. \\myfile.txt") 및 UNC 공유 이름("\\\\shared directory\\myfile.txt")이 지원됩니다. 파일을 찾을 수 없으면 예외 FileNotFoundException 가 throw됩니다.

매개 변수는 flags 파일 전송에 대한 추가 정보를 제공합니다. 이 매개 변수를 사용하는 방법에 대한 자세한 내용은 를 참조하세요 TransmitFileOptions.

를 구현하는 콜백을 AsyncCallbackBeginSendFile 전달하여 작업 완료에 대한 알림을 받을 수 있습니다. 기본 네트워크 스택이 동기적으로 작업을 완료하는 경우 콜백은 를 호출 BeginSendFile하는 동안 인라인으로 실행됩니다. 이 경우 반환 IAsyncResult 된 의 CompletedSynchronously 속성이 로 설정 true 되어 메서드가 동기적으로 완료되었음을 나타냅니다. 사용 하 여는 의 AsyncStateIAsyncResult 속성을 메서드에 전달 된 상태 개체를 BeginSendFile 가져옵니다.

메서드를 BeginSendFile 호출 EndSendFile 하여 작업을 완료해야 합니다. 일반적으로 메서드는 제공된 대리자에서 호출됩니다 AsyncCallback . EndSendFile 는 작업이 완료될 때까지 호출 스레드를 차단합니다.

연결 지향 프로토콜을 위한 것이지만, BeginSendFile 또는 BeginConnect 메서드를 먼저 호출 Connect 하여 기본 원격 호스트를 설정하는 경우 연결 없는 프로토콜에서도 작동합니다. 연결이 없는 프로토콜을 사용하면 파일 크기가 기본 서비스 공급자의 최대 패킷 크기를 초과하지 않는지 확인해야 합니다. 이 경우 데이터그램이 전송 BeginSendFile 되지 않고 예외가 SocketException throw됩니다.