VsTextBufferClass.GetLineData-Methode
Bietet direkten, Zeile-ausgerichteten Zugriff auf den Textpuffer.
Namespace: Microsoft.VisualStudio.TextManager.Interop
Assembly: Microsoft.VisualStudio.TextManager.Interop (in Microsoft.VisualStudio.TextManager.Interop.dll)
Syntax
'Declaration
Public Overridable Function GetLineData ( _
iLine As Integer, _
<OutAttribute> pLineData As LINEDATA(), _
pMarkerData As MARKERDATA() _
) As Integer
public virtual int GetLineData(
int iLine,
LINEDATA[] pLineData,
MARKERDATA[] pMarkerData
)
public:
virtual int GetLineData(
[InAttribute] int iLine,
[OutAttribute] array<LINEDATA>^ pLineData,
[InAttribute] array<MARKERDATA>^ pMarkerData
)
abstract GetLineData :
iLine:int *
pLineData:LINEDATA[] byref *
pMarkerData:MARKERDATA[] -> int
override GetLineData :
iLine:int *
pLineData:LINEDATA[] byref *
pMarkerData:MARKERDATA[] -> int
public function GetLineData(
iLine : int,
pLineData : LINEDATA[],
pMarkerData : MARKERDATA[]
) : int
Parameter
iLine
Typ: Int32[in] Zuzugreifen Puffer. Dies ist ein nullbasierter Wert.
pLineData
Typ: array<Microsoft.VisualStudio.TextManager.Interop.LINEDATA[][in, out] Die ausgefüllte LINEDATA Struktur. Dies wird vom Aufrufer zugeordnet und ausgefüllt von der GetLineData-Methode.
pMarkerData
Typ: array<Microsoft.VisualStudio.TextManager.Interop.MARKERDATA[][in, optional] MARKERDATA Struktur. Verwenden Sie GetMarkerData , um die Zeilen MARKERDATA Struktur für den Bereich auszufüllen, den Sie angeben. Wenn Sie Syntaxfarben- und Marker LINEDATA-Attribute in der Struktur (pLineData) zurückkehren möchten, müssen Sie in diesen Parameter übergeben.
Rückgabewert
Typ: Int32
Wenn die Methode erfolgreich ausgeführt, gibt sie S_OKzurück.Bei einem Fehler wird ein Fehlercode zurückgegeben.
Implementiert
IVsTextLines.GetLineData(Int32, array<LINEDATA[], array<MARKERDATA[])
Hinweise
Wenn Sie VsTextBufferClass.GetLineData aufrufen, wird ein Zeiger auf die internen Daten des Puffers zu gewährleisten. Sie können diese Methode nur verwenden, um jeweils eine Zeile im Puffer zuzugreifen.
Diese Methode gibt die Daten für die Zeile in einer LINEDATA Struktur zurück und kann schnell zur Überprüfung verwendet werden, den Inhalt eines Puffers. Wenn Sie den zeilenweise Text lesen möchten, ist es viel schneller als LINEDATA abzurufen und zu lesen, das Methoden CopyLineText oder - GetLineTextaufzurufen.
Hinweis
VsTextBufferClass.GetLineData verwendet Zeiger auf die internen Daten des Puffers.Der Puffer wird gesperrt, bis die ReleaseLineData-Methode aufgerufen wird.Jeder erfolgreichen Aufruf von GetLineData muss ReleaseLineData mit demselben LINEDATA Zeiger aufrufen.Der Parameter pMarkerData, wenn nicht NULL, gibt an, dass die Attributdaten auch angefordert wird.Der angegebene pMarkerData muss durch einen vorherigen Aufruf der GetMarkerData-Methode abgerufen werden.
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.