CodeClass.GetStartPoint - метод

Статья
08/11/2011

Возвращает объект TextPoint, отмечающий начало определения элемента кода.

Пространство имен: EnvDTE
Сборка: EnvDTE (в EnvDTE.dll)

Синтаксис

'Декларация
Function GetStartPoint ( _
    Part As vsCMPart _
) As TextPoint

TextPoint GetStartPoint(
    vsCMPart Part
)

TextPoint^ GetStartPoint(
    [InAttribute] vsCMPart Part
)

abstract GetStartPoint : 
        Part:vsCMPart -> TextPoint

function GetStartPoint(
    Part : vsCMPart
) : TextPoint

Параметры

Part
Тип: EnvDTE.vsCMPart
Необязательный.Константа vsCMPart, задающая извлекаемую часть кода.

Возвращаемое значение

Тип: EnvDTE.TextPoint
Объект TextPoint.

Заметки

Методы GetStartPoint и GetEndPoint возвращают объект TextPoint, который представляет начало и конец указанного определения элемента кода. Параметр Part определяет возвращаемое определение элемента кода.

Примечание

Значения элементов модели кода, таких как классы, структуры, функции, атрибуты, делегаты и т.п., после внесения некоторых изменений могут стать недетерминированными, иными словами, нельзя рассчитывать, что их значения не будут изменяться.Дополнительные сведения см. в разделе "Значения элементов модели кода могут изменяться" раздела Практическое руководство. Поиск кода при помощи модели кода (Visual Basic).

Примеры

 Sub GetStartPointExample(ByVal dte As DTE2)

    ' Before running this example, open a code document from a project
    ' and place the insertion point inside a class definition.
    Try
        ' Retrieve the CodeClass at the insertion point.
        Dim sel As TextSelection = _
            CType(dte.ActiveDocument.Selection, TextSelection)
        Dim cls As CodeClass = _
            CType(sel.ActivePoint.CodeElement( _
            vsCMElement.vsCMElementClass), CodeClass)

        ' Display the source code for the class.
        Dim start As TextPoint = cls.GetStartPoint()
        Dim finish As TextPoint = cls.GetEndPoint()
        Dim src As String = start.CreateEditPoint().GetText(finish)

        MsgBox(cls.Name & "'s source code:" & vbCrLf & vbCrLf & src)
    Catch ex As Exception
        MsgBox(ex.Message)
    End Try

End Sub

public void GetStartPointExample(DTE2 dte)
{
    // Before running this example, open a code document from a project
    // and place the insertion point inside a class definition.
    try
    {
        // Retrieve the CodeClass at the insertion point.
        TextSelection sel = 
            (TextSelection)dte.ActiveDocument.Selection;
        CodeClass cls = 
            (CodeClass)sel.ActivePoint.get_CodeElement(
            vsCMElement.vsCMElementClass);

        // Display the source code for the class.
        TextPoint start = cls.GetStartPoint(vsCMPart.vsCMPartWhole);
        TextPoint finish = cls.GetEndPoint(vsCMPart.vsCMPartWhole);
        string src = start.CreateEditPoint().GetText(finish);

        MessageBox.Show(cls.Name + "'s source code:" + 
            Environment.NewLine + Environment.NewLine + src);
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.