FileStream.Write 메서드

  • 참조

정의

네임스페이스:
System.IO
어셈블리:
System.Runtime.dll
어셈블리:
netstandard.dll
어셈블리:
mscorlib.dll, System.IO.FileSystem.dll
어셈블리:
System.IO.FileSystem.dll
어셈블리:
mscorlib.dll

오버로드

Write(ReadOnlySpan<Byte>)

읽기 전용 범위에서 현재 파일 스트림으로 바이트 시퀀스를 쓰고 쓴 바이트 수만큼 이 파일 스트림에서 현재 위치를 앞으로 이동합니다.
Write(Byte[], Int32, Int32)

바이트 블록을 파일 스트림에 씁니다.

Write(ReadOnlySpan<Byte>)

읽기 전용 범위에서 현재 파일 스트림으로 바이트 시퀀스를 쓰고 쓴 바이트 수만큼 이 파일 스트림에서 현재 위치를 앞으로 이동합니다.

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

매개 변수

buffer
ReadOnlySpan<Byte>

메모리 영역입니다. 이 메서드는 이 영역의 내용을 현재의 파일 스트림에 복사합니다.

예외

IOException

.NET 8 이상 버전: 기본 파이프가 닫혀 있거나 연결이 끊어졌습니다.

설명

CanWrite 속성을 사용하여 현재 인스턴스가 쓰기를 지원하는지 여부를 확인합니다. 메서드를 WriteAsync 사용하여 현재 스트림에 비동기적으로 씁니다.

쓰기 작업이 성공하면 파일 스트림 내의 위치가 기록된 바이트 수만큼 진행됩니다. 예외가 발생하면 파일 스트림 내의 위치는 변경되지 않습니다.

적용 대상

Write(Byte[], Int32, Int32)

바이트 블록을 파일 스트림에 씁니다.

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

매개 변수

arraybuffer
Byte[]

스트림에 쓸 데이터를 포함하는 버퍼입니다.

offset
Int32

스트림으로 바이트를 복사하기 시작할 array의 바이트 오프셋(0부터 시작)입니다.

count
Int32

쓸 최대 바이트 수입니다.

예외

ArgumentNullException

array이(가) null인 경우

ArgumentException

offset 및 count가 array에서 잘못된 범위를 설명하는 경우

ArgumentOutOfRangeException

offset 또는 count가 음수입니다.

IOException

I/O 오류가 발생했습니다.

또는

다른 스레드가 운영 체제 파일 핸들의 위치를 예기치 않게 변경했을 수 있습니다.

또는

.NET 8 이상 버전: 기본 파이프가 닫혀 있거나 연결이 끊어졌습니다.

ObjectDisposedException

스트림이 닫혔습니다.

NotSupportedException

현재 스트림 인스턴스가 쓰기를 지원하지 않습니다.

예제

이 코드 예제는에 대해 제공 된 큰 예제의 일부는 Lock 메서드.

// Write the original file data.
if ( fileStream->Length == 0 )
{
   tempString = String::Concat( lastRecordText, recordNumber.ToString() );
   fileStream->Write( uniEncoding->GetBytes( tempString ), 0, uniEncoding->GetByteCount( tempString ) );
}

// Write the original file data.
if(fileStream.Length == 0)
{
    tempString =
        lastRecordText + recordNumber.ToString();
    fileStream.Write(uniEncoding.GetBytes(tempString),
        0, uniEncoding.GetByteCount(tempString));
}

// Write the original file data.
if fileStream.Length = 0 then
    let tempString = lastRecordText + string recordNumber
    fileStream.Write(uniEncoding.GetBytes tempString, 0, uniEncoding.GetByteCount tempString)

' Write the original file data.
If aFileStream.Length = 0 Then
    tempString = _
        lastRecordText + recordNumber.ToString()
    aFileStream.Write(uniEncoding.GetBytes(tempString), _
        0, uniEncoding.GetByteCount(tempString))
End If

설명

이 메서드는 Write를 재정의합니다.

매개 변수는 offset 복사를 시작할 의 바이트 array 오프셋(버퍼 인덱스)을 제공하고 매개 count 변수는 스트림에 기록될 바이트 수를 제공합니다. 쓰기 작업이 성공하면 스트림의 현재 위치는 기록된 바이트 수만큼 진행됩니다. 예외가 발생하면 스트림의 현재 위치가 변경되지 않습니다.

참고

CanWrite 속성을 사용하여 현재 인스턴스가 쓰기를 지원하는지 여부를 확인합니다. 자세한 내용은 CanWrite을 참조하십시오.

쓰기 작업을 수행하는 스레드를 중단하지 마세요. 애플리케이션 스레드가 차단 해제 되 면 성공적으로 실행 하려면 나타날 수 있습니다 하지만 애플리케이션의 성능 및 안정성 중단 줄일 수 있습니다.

일반적인 파일 및 디렉터리 작업 목록은 일반적인 I/O 작업을 참조하세요.

추가 정보

적용 대상