Share via

ReadText 메서드

  • 아티클

텍스트 Stream 개체에서 지정된 수의 문자를 읽습니다.

구문

  
String = Stream.ReadText ( NumChars)

매개 변수

NumChars
(선택 사항) 파일에서 읽을 문자 수, 즉 StreamReadEnum 값을 지정하는 Long 값입니다. 기본값은 adReadAll입니다.

Return Value

ReadText 메서드는 Stream 개체에서 지정된 수의 문자, 전체 줄 또는 전체 스트림을 읽고 결과 문자열을 반환합니다.

설명

NumChar가 스트림에 남아 있는 문자 수보다 많은 경우 남아 있는 문자만 반환됩니다. 읽은 문자열은 NumChar에 지정된 길이와 일치하도록 채워지지 않습니다. 읽을 문자가 없으면 값이 null인 변형이 반환됩니다. ReadText는 거꾸로 읽는 데 사용할 수 없습니다.

참고

ReadText 메서드는 텍스트 스트림(Type이 adTypeText)에서 사용됩니다. 이진 스트림(Type이 adTypeBinary)의 경우 Read를 사용합니다.

ADO(ActiveX Data Object) Stream 개체의 ReadText 메서드를 통해 대량의 XML 데이터가 반환되는 쿼리는 실행하는 데 많은 시간이 걸릴 수 있습니다. ASP 페이지에서 호출되는 COM+ 구성 요소에서 이 작업을 수행하면 사용자의 세션 시간이 초과될 수 있습니다. ADO는 Stream 개체 데이터를 UTF-8 인코딩에서 유니코드로 변환합니다. 이러한 대량의 데이터를 한 번에 변환하는 데 발생하는 빈번한 메모리 재할당은 시간이 많이 걸립니다. 이를 해결하려면 ADO 명령 개체의 ReadText 메서드를 반복적으로 호출하고 더 적은 수의 문자를 지정합니다. 테스트 결과 128K(131,072)에 해당하는 값이 최적인 것으로 나타났습니다. 이 값이 감소하면 응답 시간이 줄어듭니다. 자세한 내용은 Microsoft 기술 자료(https://support.microsoft.com)의 기술 자료 문서 280067 "PRB: Retrieving very large XML Documents from SQL Server 2000 by using ReadText method of ADO stream object may be slow"를 참조하세요.

적용 대상

스트림 개체(ADO)

참고 항목

Read 메서드