Socket.SendPacketsAsync(SocketAsyncEventArgs) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
파일 컬렉션 또는 메모리 데이터 버퍼의 컬렉션을 연결된 Socket 개체에 비동기적으로 보냅니다.
public:
bool SendPacketsAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);public bool SendPacketsAsync(System.Net.Sockets.SocketAsyncEventArgs e);member this.SendPacketsAsync : System.Net.Sockets.SocketAsyncEventArgs -> boolPublic Function SendPacketsAsync (e As SocketAsyncEventArgs) As Boolean매개 변수
이 SocketAsyncEventArgs 비동기 소켓 작업에 사용할 개체입니다.
반환
true I/O 작업이 보류 중인 경우
Completed 매개 변수의 e 이벤트는 작업이 완료되면 발생합니다.
false I/O 작업이 동기적으로 완료된 경우 이 경우 Completed 매개 변수의 e 이벤트가 발생하지 않으며 메서드 호출이 반환된 e 직후 매개 변수로 전달된 개체를 검사하여 작업 결과를 검색할 수 있습니다.
예외
속성에 FilePath 지정된 파일을 찾을 수 없습니다.
매개 변수에 지정된 e 개체를 SocketAsyncEventArgs 사용하여 소켓 작업이 이미 진행 중입니다.
원격 Socket 호스트에 연결되지 않았습니다.
Socket 닫혔습니다.
연결 없는 Socket 파일이 사용되고 있으며 전송되는 파일이 기본 전송의 최대 패킷 크기를 초과합니다.
설명
이 SendPacketsAsync 메서드는 파일 컬렉션을 보내거나 메모리 데이터 버퍼에서 원격 호스트로 보내는 데 사용됩니다. 원격 Socket 호스트에 이미 연결되어 있어야 합니다.
System.Net.Sockets.SendPacketsElement 작업 디렉터리에서 파일을 참조하는 경우 파일의 이름으로만 식별될 수 있습니다. 그렇지 않으면 파일의 전체 경로와 이름을 지정해야 합니다. 와일드카드 및 UNC 공유 이름이 지원됩니다. 파일을 찾을 FileNotFoundException 수 없으면 throw됩니다.
완료 알림을 받으려면 EventHandler<SocketAsyncEventArgs> 대리자를 구현하고 콜백을 이벤트에 연결하는 콜백 메서드를 SocketAsyncEventArgs.Completed 만들어야 합니다.
매개 변수의 e 속성은 SocketAsyncEventArgs.SendPacketsFlags Window Sockets 서비스 공급자에게 파일 전송에 대한 추가 정보를 제공합니다. 이 매개 변수를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요 TransmitFileOptions.
이 메서드를 성공적으로 호출하려면 개체의 System.Net.Sockets.SocketAsyncEventArgs 다음 속성과 이벤트가 필요합니다.
호출자는 콜백 메서드에서 SocketAsyncEventArgs.UserToken 정보를 검색할 수 있도록 메서드를 호출 SendPacketsAsync 하기 전에 원하는 사용자 상태 개체로 속성을 설정할 수 있습니다. 콜백에 단일 개체보다 더 많은 정보가 필요한 경우 다른 필수 상태 정보를 멤버로 유지하기 위해 작은 클래스를 만들 수 있습니다.
이 메서드는 Windows 소켓 2 API에 있는 TransmitPackets 함수를 사용합니다. TransmitPackets 함수 및 해당 플래그에 대한 자세한 내용은 Windows 소켓 설명서를 참조하세요.
연결 지향 프로토콜을 위한 것이지만, SendPacketsAsync 이 메서드는 기본 원격 호스트를 설정하기 위해 먼저 호출하거나 ConnectAsync 메서드를 호출BeginConnectConnect하는 경우 연결 없는 프로토콜에도 작동합니다. 연결 없는 프로토콜을 사용하면 파일 크기가 기본 서비스 공급자의 최대 패킷 크기를 초과하지 않는지 확인해야 합니다. 이 경우 데이터그램이 전송 SendPacketsAsync 되지 않고 예외가 SocketException throw됩니다.
이 SendPacketsAsync 메서드는 사용되는 운영 체제에 따라 최적화됩니다. Windows 서버 버전에서 SendPacketsAsync 이 메서드는 고성능에 최적화되어 있습니다.
Windows 클라이언트 버전에서 SendPacketsAsync 이 메서드는 최소 메모리 및 리소스 사용률에 최적화되어 있습니다.
매개 변수의 TransmitFileOptions.UseKernelApc 속성에 플래그를 SocketAsyncEventArgs.SendPacketsFlagse 사용하면 상당한 성능 이점을 제공할 수 있습니다. 메서드 호출을 SendPacketsAsync 시작하는 스레드가 무거운 계산에 사용되는 경우 가능성은 낮지만 APC가 시작되지 않을 수 있습니다. 커널과 사용자 모드 APC 간에는 차이가 있습니다. 스레드가 대기 상태일 때 커널 APC가 시작됩니다. 스레드가 경고 대기 상태일 때 사용자 모드 APC가 시작됩니다.
