This documentation is archived and is not being maintained.

TextSelection.InsertFromFile Method

Inserts the contents of the specified file at the current location in the buffer.

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

void InsertFromFile (
	[InAttribute] string File
)
void InsertFromFile (
	/** @attribute InAttribute() */ String File
)
function InsertFromFile (
	File : String
)

Parameters

File

Required. The name of the file to insert into the text buffer.

The edit point moves past the insertion point. The text is converted to Unicode, which is the internal representation used by text documents.

public void InsertFromFileExample(DTE2 dte)
{
    // NOTE: This example requires a reference to the
    //       System.IO namespace.

    // Create a new text file and insert 10 lines of text.
    dte.ItemOperations.NewFile(@"General\Text File", "File1", 
        Constants.vsViewKindPrimary);
    Document doc = dte.ActiveDocument;
    TextSelection sel = (TextSelection)doc.Selection;

    for (int i = 0; i < 10; ++i)
        sel.Insert("This is a test.\n", 
           (int)vsInsertFlags.vsInsertFlagsCollapseToEnd);

    MessageBox.Show("Saving and closing File1");

    // Save and close the text file.
    string file1 = Path.GetTempPath() + "File1.txt";
    doc.Save(file1);
    doc.Close(vsSaveChanges.vsSaveChangesNo);

    // Create a new text file.
    dte.ItemOperations.NewFile(@"General\Text File", "File2", 
        Constants.vsViewKindPrimary);
    doc = dte.ActiveDocument;

    if (MessageBox.Show("Insert text from File1 into File2?", "", 
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        sel = (TextSelection)doc.Selection;
        sel.InsertFromFile(file1);
    }
}
Show: