Stream.Seek(Int64, SeekOrigin) 메서드

정의

파생 클래스를 재정의될 때 현재 스트림 내의 위치를 설정합니다.When overridden in a derived class, sets the position within the current stream.

public:
 abstract long Seek(long offset, System::IO::SeekOrigin origin);
public abstract long Seek (long offset, System.IO.SeekOrigin origin);
abstract member Seek : int64 * System.IO.SeekOrigin -> int64
Public MustOverride Function Seek (offset As Long, origin As SeekOrigin) As Long

매개 변수

offset
Int64

origin 매개 변수에 상대적인 바이트 오프셋입니다.A byte offset relative to the origin parameter.

origin
SeekOrigin

새 위치를 가져오는 데 사용되는 참조 위치를 나타내는 SeekOrigin 형식의 값입니다.A value of type SeekOrigin indicating the reference point used to obtain the new position.

반환

현재 스트림 내의 새 위치입니다.The new position within the current stream.

예외

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

예를 들어, 스트림이 파이프 또는 콘솔 출력에서 생성되는 경우 스트림은 검색을 지원하지 않습니다.The stream does not support seeking, such as if the stream is constructed from a pipe or console output.

스트림이 닫힌 후에 메서드가 호출되었습니다.Methods were called after the stream was closed.

설명

현재 인스턴스에서 검색을 지원 하는지 여부를 확인 하려면 CanSeek 속성을 사용 합니다.Use the CanSeek property to determine whether the current instance supports seeking.

offset 음수인 경우에는 origin에 지정 된 위치 앞에 offset으로 지정 된 바이트 수 만큼 새 위치가 필요 합니다.If offset is negative, the new position is required to precede the position specified by origin by the number of bytes specified by offset. offset가 0 인 경우 origin에서 지정 된 위치에 새 위치가 필요 합니다.If offset is zero (0), the new position is required to be the position specified by origin. offset가 양수인 경우에는 origin에 지정 된 위치에 따라 offset에서 지정한 바이트 수 만큼 새 위치가 필요 합니다.If offset is positive, the new position is required to follow the position specified by origin by the number of bytes specified by offset.

검색을 지 원하는 Stream에서 파생 된 클래스는이 메서드를 재정의 하 여 위에서 설명한 기능을 제공 해야 합니다.Classes derived from Stream that support seeking must override this method to provide the functionality described above.

스트림의 길이 초과 하는 위치 검색을 지원 합니다.Seeking to any location beyond the length of the stream is supported.

적용 대상

추가 정보