This documentation is archived and is not being maintained.

NamedRange.PrintOut Method

Prints the NamedRange control.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Object PrintOut(
	Object From,
	Object To,
	Object Copies,
	Object Preview,
	Object ActivePrinter,
	Object PrintToFile,
	Object Collate,
	Object PrToFileName


Type: System.Object
The number of the page at which to start printing. If this argument is omitted, printing starts at the beginning.
Type: System.Object
The number of the last page to print. If this argument is omitted, printing ends with the last page.
Type: System.Object
The number of copies to print. If this argument is omitted, one copy is printed.
Type: System.Object
true to have Microsoft Office Excel invoke print preview before printing the object; false (or omitted) to print the object immediately.
Type: System.Object
Sets the name of the active printer.
Type: System.Object
true to print to a file. If PrToFileName is not specified, Excel prompts the user to enter the name of the output file.
Type: System.Object
true to collate multiple copies.
Type: System.Object
If PrintToFile is set to true, this argument specifies the name of the file you want to print to.

Return Value

Type: System.Object

"Pages" in the descriptions of From and To refers to printed pages, not necessarily to all of the pages in the sheet or workbook.

Optional Parameters

For information on optional parameters, see Optional Parameters in Office Solutions.

The following code example sets the values of the cells in a NamedRange control to random numbers, and then uses the PrintOut method to print the contents of the named range.

This example is for a document-level customization.

private void PrintOutPreviewRange()
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "E5"],

    namedRange1.Formula = "=Rand()";
    namedRange1.PrintOut(1, 1, 1, true, missing, missing,
        false, missing);