Stream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
비동기 쓰기 작업을 시작합니다. 대신 WriteAsync(Byte[], Int32, Int32)를 사용하세요.
public:
virtual IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);public virtual IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback? callback, object? state);public virtual IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object state);public virtual IAsyncResult BeginWrite (byte[] buffer, int offset, int count, AsyncCallback callback, object? state);abstract member BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult매개 변수
- buffer
- Byte[]
데이터를 쓸 버퍼입니다.
- offset
- Int32
쓰기를 시작할 buffer의 바이트 오프셋입니다.
- count
- Int32
쓸 최대 바이트 수입니다.
- callback
- AsyncCallback
쓰기가 완료되면 호출되는 선택적 비동기 콜백입니다.
- state
- Object
다른 요청에서 특정 비동기 쓰기 요청을 구별하는 사용자 제공 개체입니다.
반환
보류 중인 비동기 쓰기를 나타내는 IAsyncResult입니다.
예외
스트림의 끝을 넘어 비동기 쓰기를 시도했거나 디스크 오류가 발생한 경우
하나 이상의 인수가 잘못된 경우
스트림이 닫힌 후에 메서드가 호출되었습니다.
현재 Stream 구현이 쓰기 작업을 지원하지 않는 경우
설명
.NET Framework 4 및 이전 버전에서 비동기 I/O 작업을 구현하려면 BeginWrite 및 EndWrite와 같은 메서드를 사용해야 합니다. 이러한 메서드는 레거시 코드를 지원하기 위해 .NET Framework 4.5에서 계속 사용할 수 있지만, 비동기 I/O 작업을 보다 쉽게 구현하는 데 도움이 되는 새로운 비동기 메서드(예: ReadAsync, WriteAsyncCopyToAsync및FlushAsync)가 있습니다.
스트림의 BeginWrite 기본 구현은 메서드를 Write 동기적으로 호출합니다. 즉 Write , 일부 스트림에서 차단될 수 있습니다. 그러나 인스턴스를 비동기적으로 연 경우와 같은 FileStream NetworkStream 클래스의 인스턴스는 비동기 작업을 완전히 지원합니다. 따라서 호출 BeginWrite 은 해당 스트림에서 차단되지 않습니다. 예를 들어 비동기 대리자를 사용하여 비동기 동작을 제공하도록 재정 BeginWrite 의할 수 있습니다.
쓰기가 IAsyncResult 완료되고 리소스를 적절하게 해제하도록 EndWrite 현재 메서드에서 반환된 내용을 전달합니다. EndWrite 에 대한 모든 호출에 대해 한 번 호출해야 합니다 BeginWrite. 호출 BeginWrite 한 것과 동일한 코드를 사용하거나 전달된 콜백에서 이 작업을 수행할 수 있습니다 BeginWrite. 비동기 쓰기 중에 오류가 발생하면 이 메서드에서 반환된 예외를 사용하여 호출될 때까지 EndWrite 예외가 IAsyncResult throw되지 않습니다.
스트림을 쓸 수 있는 경우 스트림의 끝에 쓰면 스트림이 확장됩니다.
I/O 작업이 완료되는 시점이 아니라 비동기 읽기 또는 쓰기를 실행할 때 스트림의 현재 위치가 업데이트됩니다. 여러 동시 비동기 요청은 요청 완료 순서를 불확실하게 렌더링합니다.
CanWrite 이 속성을 사용하여 현재 인스턴스가 쓰기를 지원하는지 여부를 확인합니다.
스트림이 닫혀 있거나 잘못된 인수를 전달하면 예외가 즉시 BeginWritethrow됩니다. I/O 요청 중 디스크 오류와 같은 비동기 쓰기 요청 중에 발생하는 오류는 스레드 풀 스레드에서 발생하고 호출 EndWrite할 때 예외를 throw합니다.