IVsTextLines.GetLineData 方法

提供文字緩衝區的直接、 導向式存取。

命名空間：  Microsoft.VisualStudio.TextManager.Interop
組件：  Microsoft.VisualStudio.TextManager.Interop (在 Microsoft.VisualStudio.TextManager.Interop.dll 中)

語法

'宣告
Function GetLineData ( _
    iLine As Integer, _
    <OutAttribute> pLineData As LINEDATA(), _
    pMarkerData As MARKERDATA() _
) As Integer

int GetLineData(
    int iLine,
    LINEDATA[] pLineData,
    MARKERDATA[] pMarkerData
)

int GetLineData(
    [InAttribute] int iLine, 
    [OutAttribute] array<LINEDATA>^ pLineData, 
    [InAttribute] array<MARKERDATA>^ pMarkerData
)

abstract GetLineData : 
        iLine:int * 
        pLineData:LINEDATA[] byref * 
        pMarkerData:MARKERDATA[] -> int

function GetLineData(
    iLine : int, 
    pLineData : LINEDATA[], 
    pMarkerData : MARKERDATA[]
) : int

參數

• iLine
  類型：Int32

  [in]若要存取的緩衝區行。 這是以零起始的值。

• pLineData
  類型：array<Microsoft.VisualStudio.TextManager.Interop.LINEDATA[]

  輸入 [、 輸出]填滿的LINEDATA結構。 這是由呼叫端所配置而且填入的GetLineData方法。

• pMarkerData
  類型：array<Microsoft.VisualStudio.TextManager.Interop.MARKERDATA[]

  [in，選用]MARKERDATA結構。 使用GetMarkerData來填滿MARKERDATA結構，如您所指定的行範圍。 如果您想要傳回的語法標色和標記屬性LINEDATA結構 (pLineData)，則您需要這個參數中傳遞。

傳回值

類型：Int32
如果此方法將會成功，則會傳回S_OK。如果失敗，它就會傳回錯誤碼。

備註

COM 簽章

從 textmgr.idl：

HRESULT IVsTextLines::GetLineData(
   [in] long iLine,
   [out] LINEDATA *pLineData,
   [in] MARKERDATA *pMarkerData
);

當您呼叫IVsTextLines.GetLineData到緩衝區的內部資料所提供的指標。 您只能使用這個方法一次存取緩衝區中的某一行。

這個方法會傳回資料中的行LINEDATA結構，並可用來快速地探查緩衝區的內容。 如果您想要讀取文字--琵式，則取得，並閱讀快很多LINEDATA比若要呼叫的方法CopyLineText或GetLineText。

注意事項
IVsTextLines.GetLineData使用緩衝區的內部資料的指標。緩衝區已凍結等到ReleaseLineData ，會呼叫方法。任何成功呼叫GetLineData必須呼叫ReleaseLineData與相同LINEDATA指標。參數pMarkerData，若有非 null，表示也要求之屬性的資料。pMarkerData給必須取得前一個呼叫GetMarkerData方法。

.NET Framework 安全性

• 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。

請參閱

參考

IVsTextLines 介面

Microsoft.VisualStudio.TextManager.Interop 命名空間