IVsTextScanner Interface

Definition

Namespace:

Microsoft.VisualStudio.TextManager.Interop

Assembly:

Microsoft.VisualStudio.Interop.dll

Package:

Microsoft.VisualStudio.Interop v17.12.40391

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

public interface class IVsTextScanner

public interface class IVsTextScanner

__interface IVsTextScanner

[System.Runtime.InteropServices.ComConversionLoss]
[System.Runtime.InteropServices.Guid("EBD73923-C190-45C1-91C5-0BC61A8AAB14")]
[System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)]
public interface IVsTextScanner

[<System.Runtime.InteropServices.ComConversionLoss>]
[<System.Runtime.InteropServices.Guid("EBD73923-C190-45C1-91C5-0BC61A8AAB14")>]
[<System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)>]
type IVsTextScanner = interface

Public Interface IVsTextScanner

Attributes

ComConversionLossAttribute GuidAttribute InterfaceTypeAttribute

Remarks

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.

Methods

CloseScan()	Closes the buffer for scanning and re-enables writing to the buffer.
OpenScan()	Opens the text buffer for scanning.
Read(String, Int32)	Performs a scan of the text buffer, or portion of the text buffer defined by the string length, piLength.