TextSelection.Text-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

Legt den markierten Text fest oder ruft ihn ab.

Namespace: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Syntax

Default Property Text As String

Dim instance As TextSelection
Dim value As String

value = instance

instance = value

string this { get; set; }

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

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

Eigenschaftenwert

Typ: System.String

Eine Zeichenfolge, die den markierten Text darstellt.

Hinweise

Die Text-Eigenschaft ist die Standardeigenschaft für das TextSelection-Objekt.

Beim Lesen der Text-Eigenschaft wird der Text innerhalb der Markierung zurückgegeben, wobei diese nicht geändert wird.

Beim Festlegen der Text-Eigenschaft wird der Wert von Text vor dem markierten Text eingefügt und dann ausgeblendet, ähnlich dem Verfahren zum Einfügen von Text in ein Dokument. Das Verhalten dieser Eigenschaft entspricht dem Verhalten des Editors im Einfügemodus (d. h. nicht überschreiben). Text nach dem 128. Zeichen wird abgeschnitten.

Wenn der Wert der Mode-Eigenschaft des TextSelection-Objekts Column lautet, wird durch Festlegen der Text-Eigenschaft ein Fehler verursacht.

Beispiele

Dieses Beispiel funktioniert nur in Visual Studio .NET 2003. Weitere Informationen finden Sie unter Gewusst wie: Migrieren von Code, durch den Projekte mithilfe von Vorlagen erstellt werden.

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";
}

Berechtigungen

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.