다음을 통해 공유


Stream.SetLength 메서드

파생 클래스에 재정의될 때 현재 스트림의 길이를 설정합니다.

네임스페이스: System.IO
어셈블리: mscorlib(mscorlib.dll)

구문

‘선언
Public MustOverride Sub SetLength ( _
    value As Long _
)
‘사용 방법
Dim instance As Stream
Dim value As Long

instance.SetLength(value)
public abstract void SetLength (
    long value
)
public:
virtual void SetLength (
    long long value
) abstract
public abstract void SetLength (
    long value
)
public abstract function SetLength (
    value : long
)

매개 변수

  • value
    원하는 현재 스트림의 길이(바이트)입니다.

예외

예외 형식 조건

IOException

I/O 오류가 발생하는 경우

NotSupportedException

예를 들어, 스트림이 파이프 또는 콘솔 출력에서 생성되는 경우처럼 스트림이 쓰기와 검색을 모두 지원하지 않는 경우

ObjectDisposedException

스트림이 닫힌 후 메서드가 호출된 경우

설명

파일을 만들고 파일에 텍스트를 쓰는 방법에 대한 예제를 보려면 방법: 파일에 텍스트 쓰기를 참조하십시오. 파일에서 텍스트를 읽는 방법에 대한 예제를 보려면 방법: 파일의 텍스트 읽기를 참조하십시오. 이진 파일을 읽거나 쓰는 방법에 대한 예제를 보려면 방법: 새로 만든 데이터 파일 읽기 및 쓰기를 참조하십시오.

지정한 값이 스트림의 현재 길이보다 작으면 스트림을 자르고, 지정한 값이 스트림의 현재 길이보다 크면 스트림을 확장합니다. 스트림을 확장하면 이전 길이와 새 길이 사이의 스트림 내용이 정의되지 않습니다.

SetLength를 동작시키려면 스트림이 쓰기와 검색을 모두 지원해야 합니다.

현재 인스턴스가 쓰기를 지원하는지 여부를 결정하려면 CanWrite 속성을 사용하고, 검색이 지원되는지 여부를 결정하려면 CanSeek 속성을 사용합니다.

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

Stream 클래스
Stream 멤버
System.IO 네임스페이스

기타 리소스

파일 및 스트림 I/O
방법: 파일의 텍스트 읽기
방법: 파일에 텍스트 쓰기