TextSelection.Text - свойство

Статья
11/01/2012

Задает или возвращает выделенный текст.

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

Синтаксис

'Декларация
Default Property Text As String

string this { get; set; }

property String^ default {
    String^ get ();
    void set (String^ value);
}

abstract Text : string with get, set

function get Text () : String
function set Text (value : String)

Значение свойства

Тип: System.String
Строковое выражение, предоставляющее выделенный текст.

Заметки

Свойство Text является свойством по умолчанию для объекта TextSelection.

При чтении свойства Text возвращается выделенный фрагмент текста, при этом сам выделенный фрагмент остается неизменным.

Если свойство Text установлено, значение Text вставляется перед выделенным текстом, а затем свертывается, аналогично тому, как это происходит при вставке текста в документ.Обратите внимание, что при использовании этого свойства редактор ведет себя так же, как при вводе с клавиатуры, если редактор находится в режиме вставки (т. е. не в режиме замены).Любой текст после 128-го знака отбрасывается.

Если свойство Mode объекта TextSelection установлено Column, то параметр свойства Text генерирует ошибку.

Примеры

Этот пример работает только в Visual Studio .NET 2003.Дополнительные сведения см. в разделе Migrating Code that Creates Projects by Using Templates.

Sub TextExample(ByVal dte As DTE)

    ' NOTE: This examples requires a reference to the 
    '       VSLangProj namespace.

    ' Create a new solution.
    Dim soln As Solution = dte.Solution
    Dim solnName As String = "NewSolution.sln"
    Dim tempPath As String = System.IO.Path.GetTempPath()
    soln.Create(tempPath, solnName)

    ' Create a new Visual Basic Console Application project.
    Dim templatePath As String = 
        dte.Solution.TemplatePath(PrjKind.prjKindVBProject)
    templatePath &= "ConsoleApplication.vsz"
    Dim projName As String = "NewProject"
    soln.AddFromTemplate(templatePath, tempPath & projName, projName)
    Dim proj As Project = soln.Item(1)

    ' Add a comment to Module1.vb.
    Dim item As ProjectItem = proj.ProjectItems.Item("Module1.vb")
    Dim sel As TextSelection = CType(item.Document.Selection, 
        TextSelection)

    sel.StartOfDocument()
    sel.NewLine()
    sel.LineUp()
    sel.Text = "' New comment" & vbCrLf

End Sub

public void TextExample(DTE dte)
{
    // NOTE: This examples requires a reference to the 
    //       VSLangProj namespace.

    // Create a new solution.
    Solution soln = dte.Solution;
    string solnName = "NewSolution.sln";
    string tempPath = System.IO.Path.GetTempPath();
    soln.Create(tempPath, solnName);

    // Create a new C# Console Application project.
    string templatePath = 
        dte.Solution.get_TemplatePath(PrjKind.prjKindCSharpProject);
    templatePath += "CSharpConsole.vsz";
    string projName = "Project1";
    soln.AddFromTemplate(templatePath, tempPath + projName, 
        projName, false);
    Project proj = soln.Item(1);

    // Add a comment to Class1.cs.
    ProjectItem item = proj.ProjectItems.Item("Class1.cs");
    TextSelection sel = (TextSelection)item.Document.Selection;

    sel.StartOfDocument(false);
    sel.NewLine(1);
    sel.LineUp(false, 1);
    sel.Text = "// New comment\n";
}

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

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