FileStream.SetLength(Int64) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
이 스트림의 길이를 제공된 값으로 설정합니다.
public:
override void SetLength(long value);public override void SetLength (long value);override this.SetLength : int64 -> unitPublic Overrides Sub SetLength (value As Long)매개 변수
- value
- Int64
스트림의 새 길이입니다.
예외
I/O 오류가 발생했습니다.
스트림이 쓰기 및 검색 둘 다를 지원하지는 않습니다.
value 매개 변수를 0 미만으로 설정하려 한 경우
설명
이 메서드는 SetLength를 재정의합니다.
지정된 값이 스트림의 현재 길이보다 작으면 스트림이 잘립니다. 이 시나리오에서 현재 위치가 새 길이보다 크면 현재 위치가 스트림의 마지막 바이트로 이동됩니다. 지정된 값이 스트림의 현재 길이보다 크면 스트림이 확장되고 현재 위치는 동일하게 유지됩니다. 스트림이 확장되면 Windows에서 이전 길이와 새 길이 사이의 스트림 내용이 정의되지 않은 반면 Linux에서는 해당 공간이 0으로 채워집니다.
스트림은 쓰기 및 작업 검색을 SetLength 모두 지원해야 합니다.
참고
CanWrite 속성을 사용하여 현재 인스턴스가 쓰기를 지원하는지 여부와 CanSeek 검색이 지원되는지 여부를 확인하는 속성을 사용합니다. 자세한 내용은 CanWrite 및 CanSeek를 참조하십시오.
일반적인 파일 및 디렉터리 작업 목록은 일반적인 I/O 작업을 참조하세요.