Stream.Write 메서드

정의

오버로드

Write(ReadOnlySpan<Byte>)

파생 클래스를 재정의될 때 현재 스트림에 바이트의 시퀀스를 쓰고 쓰여진 바이트 수만큼 이 스트림 내에서 앞으로 이동합니다.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

Write(Byte[], Int32, Int32)

파생 클래스를 재정의될 때 현재 스트림에 바이트의 시퀀스를 쓰고 쓰여진 바이트 수만큼 이 스트림 내에서 앞으로 이동합니다.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

Write(ReadOnlySpan<Byte>)

파생 클래스를 재정의될 때 현재 스트림에 바이트의 시퀀스를 쓰고 쓰여진 바이트 수만큼 이 스트림 내에서 앞으로 이동합니다.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

public:
 virtual void Write(ReadOnlySpan<System::Byte> buffer);
public virtual void Write (ReadOnlySpan<byte> buffer);
abstract member Write : ReadOnlySpan<byte> -> unit
override this.Write : ReadOnlySpan<byte> -> unit
Public Overridable Sub Write (buffer As ReadOnlySpan(Of Byte))

매개 변수

buffer
ReadOnlySpan<Byte>

메모리 영역입니다.A region of memory. 이 메서드는 이 영역의 내용을 현재의 스트림에 복사합니다.This method copies the contents of this region to the current stream.

설명

CanWrite현재 인스턴스가 쓰기를 지원 하는지 여부를 확인 하려면 속성을 사용 합니다.Use the CanWrite property to determine whether the current instance supports writing. 메서드를 사용 WriteAsync 하 여 현재 스트림에 비동기적으로 씁니다.Use the WriteAsync method to write asynchronously to the current stream.

쓰기 작업이 성공 하면 스트림 내의 위치가 쓰여진 바이트 수 만큼 앞으로 이동 합니다.If the write operation is successful, the position within the stream advances by the number of bytes written. 예외가 발생 하면 스트림 내의 위치는 변경 되지 않은 상태로 유지 됩니다.If an exception occurs, the position within the stream remains unchanged.

적용 대상

Write(Byte[], Int32, Int32)

파생 클래스를 재정의될 때 현재 스트림에 바이트의 시퀀스를 쓰고 쓰여진 바이트 수만큼 이 스트림 내에서 앞으로 이동합니다.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

public:
 abstract void Write(cli::array <System::Byte> ^ buffer, int offset, int count);
public abstract void Write (byte[] buffer, int offset, int count);
abstract member Write : byte[] * int * int -> unit
Public MustOverride Sub Write (buffer As Byte(), offset As Integer, count As Integer)

매개 변수

buffer
Byte[]

바이트 배열입니다.An array of bytes. 이 메서드는 buffercount 바이트를 현재 스트림으로 복사합니다.This method copies count bytes from buffer to the current stream.

offset
Int32

현재 스트림으로 바이트를 복사하기 시작할 buffer의 바이트 오프셋(0부터 시작)입니다.The zero-based byte offset in buffer at which to begin copying bytes to the current stream.

count
Int32

현재 스트림에 쓸 바이트 수입니다.The number of bytes to be written to the current stream.

예외

offsetcount의 합계가 버퍼 길이보다 큽니다.The sum of offset and count is greater than the buffer length.

buffer이(가) null인 경우buffer is null.

offset 또는 count가 음수입니다.offset or count is negative.

지정된 파일을 찾을 수 없음과 같은 I/O 오류가 발생합니다.An I/O error occurred, such as the specified file cannot be found.

스트림이 쓰기를 지원하지 않습니다.The stream does not support writing.

스트림이 닫힌 후에 Write(Byte[], Int32, Int32)가 호출되었습니다.Write(Byte[], Int32, Int32) was called after the stream was closed.

설명

CanWrite현재 인스턴스가 쓰기를 지원 하는지 여부를 확인 하려면 속성을 사용 합니다.Use the CanWrite property to determine whether the current instance supports writing. 메서드를 사용 WriteAsync 하 여 현재 스트림에 비동기적으로 씁니다.Use the WriteAsync method to write asynchronously to the current stream.

쓰기 작업이 성공 하면 스트림 내의 위치가 쓰여진 바이트 수 만큼 앞으로 이동 합니다.If the write operation is successful, the position within the stream advances by the number of bytes written. 예외가 발생 하면 스트림 내의 위치는 변경 되지 않은 상태로 유지 됩니다.If an exception occurs, the position within the stream remains unchanged.

추가 정보

적용 대상