Proprietà TextSelection.Text

Articolo
08/11/2011

Ottiene o imposta il testo selezionato.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

'Dichiarazione
Default Property Text As String
    Get
    Set

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)

Valore proprietà

Tipo: System.String
Stringa che rappresenta il testo selezionato.

Note

La proprietà Text è la proprietà predefinita per l'oggetto TextSelection.

Quando viene letta la proprietà Text, viene restituito il testo contenuto nella selezione e la selezione non viene modificata.

Quando viene impostata la proprietà Text, il valore di Text viene inserito prima del testo selezionato e quindi compresso, analogamente a quanto accade quando il testo viene incollato in un documento. Si noti che questa proprietà si comporta esattamente come accadrebbe quando per l'editor è attiva la modalità di inserimento (ovvero non di sovrascrittura). Il testo viene troncato dopo 128 caratteri.

Se la proprietà Mode dell'oggetto TextSelection è impostata su Column, l'impostazione della proprietà Text genera un errore.

Esempi

L'esempio riportato di seguito funziona solo in Visual Studio .NET 2003. Per ulteriori informazioni, vedere Procedura: eseguire la migrazione del codice con il quale si creano progetti tramite modelli.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.