MemoryStream.SetLength 메서드
현재 스트림의 길이를 지정된 값으로 설정합니다.
네임스페이스: System.IO
어셈블리: mscorlib(mscorlib.dll)
구문
‘선언
Public Overrides Sub SetLength ( _
value As Long _
)
‘사용 방법
Dim instance As MemoryStream
Dim value As Long
instance.SetLength(value)
public override void SetLength (
long value
)
public:
virtual void SetLength (
long long value
) override
public void SetLength (
long value
)
public override function SetLength (
value : long
)
매개 변수
- value
길이를 설정할 값입니다.
예외
| 예외 형식 | 조건 |
|---|---|
현재 스트림의 크기를 조정할 수 없으며 value가 현재 용량보다 큰 경우 - 또는 - 현재 스트림이 쓰기를 지원하지 않는 경우 |
|
value가 음수이거나 MemoryStream의 최대 길이보다 큰 경우. 여기서 최대 길이는 MaxValue - origin입니다. origin은 스트림이 시작되는 내부 버퍼의 인덱스입니다. |
설명
파일을 만들고 파일에 텍스트를 쓰는 방법에 대한 예제를 보려면 방법: 파일에 텍스트 쓰기를 참조하십시오. 파일에서 텍스트를 읽는 방법에 대한 예제를 보려면 방법: 파일의 텍스트 읽기를 참조하십시오. 이진 파일을 읽거나 쓰는 방법에 대한 예제를 보려면 방법: 새로 만든 데이터 파일 읽기 및 쓰기를 참조하십시오.
이 메서드는 SetLength를 재정의합니다.
지정한 값이 스트림의 현재 길이보다 작으면 스트림을 자르고, 잘림 이후에 스트림 내의 현재 위치가 스트림 끝 뒤에 있으면 ReadByte 메서드가 -1을 반환하고, Read 메서드가 0바이트를 제공된 바이트 배열로 읽어 들이고, Write 및 WriteByte 메서드가 지정된 바이트를 스트림 끝에 추가하여 스트림의 길이를 늘립니다. 지정한 값이 현재 용량보다 크며 스트림의 크기를 조정할 수 있으면 용량은 늘어나고 스트림 내의 현재 위치는 변경되지 않습니다. 길이를 늘리면 이전 길이와 새 길이 사이의 스트림 내용이 0으로 초기화됩니다.
참고
이 메서드를 동작시키려면 MemoryStream 인스턴스가 쓰기를 지원해야 합니다. 현재 인스턴스가 쓰기를 지원하는지 여부를 결정하려면 CanWrite 속성을 사용합니다. 자세한 내용은 CanWrite를 참조하십시오.
플랫폼
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에서 지원
참고 항목
참조
MemoryStream 클래스
MemoryStream 멤버
System.IO 네임스페이스