Export (0) Print
Expand All

IVsTextScanner Interface

A special-purpose interface exposed by text buffers and used to provide fast, stream-oriented, sequential access to the text in the buffer.

Namespace:  Microsoft.VisualStudio.TextManager.Interop
Assembly:  Microsoft.VisualStudio.TextManager.Interop (in Microsoft.VisualStudio.TextManager.Interop.dll)

public interface IVsTextScanner

The IVsTextScanner type exposes the following members.

Public methodCloseScanCloses the buffer for scanning and re-enables writing to the buffer.
Public methodOpenScanOpens the text buffer for scanning.
Public methodReadPerforms a scan of the text buffer, or portion of the text buffer defined by the string length, piLength.

IVsTextScanner is particularly useful to compilers, which need rapid, sequential, stream-oriented access to text in the text buffer. However, this interface locks the buffer and performs a garbage-collection pass, which incurs an expensive performance hit. Use of this interface is therefore not recommended in scenarios such as performing a query status on the handler or other performance-sensitive scenarios.

This interface allows you to obtain selected text from the text buffer. If you need access to the full contents of the text buffer, consider using IVsFullTextScanner.

Notes to Implementers

Implement IVsTextScanner to obtain quick access to the text buffer.

© 2014 Microsoft