WorksheetBase.ExportAsFixedFormat(XlFixedFormatType, Object, Object, Object, Object, Object, Object, Object, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет экспорт в файл указанного формата.
public void ExportAsFixedFormat (Microsoft.Office.Interop.Excel.XlFixedFormatType type, object filename, object quality, object includeDocProperties, object ignorePrintAreas, object from, object to, object openAfterPublish, object fixedFormatExtClassPtr);
Параметры
- type
- XlFixedFormatType
Одно из значений Microsoft.Office.Interop.Excel.XlFixedFormatType, указывающее, следует ли сохранять книгу в формате PDF или XPS.
- filename
- Object
Полный путь к новому файлу формата PDF или XPS. Если пропустить этот параметр, Excel сохранит файл в текущей папке.
- quality
- Object
Одно из значений Microsoft.Office.Interop.Excel.XlFixedFormatQuality, определяющее качество экспортируемого файла.
- includeDocProperties
- Object
Значение true, чтобы включить свойства документа в новый экспортированный файл; в противном случае — значение false.
- ignorePrintAreas
- Object
Значение true, чтобы не учитывать области печати, заданные при экспорте; в противном случае — значение false.
- from
- Object
Номер страницы, с которой начинается экспорт. Если этот аргумент пропущен, экспорт начинается с первой страницы.
- to
- Object
Номер последней страницы для экспорта. Если этот аргумент пропущен, экспорт заканчивается последней страницей.
- openAfterPublish
- Object
Значение true для незамедлительного отображения файла в средстве просмотра; в противном случае — значение false.
- fixedFormatExtClassPtr
- Object
Указатель на реализацию интерфейса IMsoDocExporter, позволяющего сохранять книгу в другом фиксированном формате. Дополнительные сведения см. в разделе Extending the Office (2007) Fixed-Format Export Feature (Расширение функции экспорта в фиксированном формате Office 2007).
Примеры
В следующем примере кода сохраняется содержимое листа Sheet1 в формате PDF, до первых четырех страниц (без учета областей печати). PDF-файл сохраняется по указанному пути к файлу и имени файла с использованием стандартного разрешения качества. Файл содержит свойства книги. Для выполнения этого примера кода книга должна содержать лист с именем Sheet1 с некоторыми данными.
Этот пример предназначен для настройки на уровне документа.
private void SaveWorksheetAsPDF()
{
Microsoft.Office.Tools.Excel.Worksheet mySheet =
Globals.Sheet1.Base;
mySheet.ExportAsFixedFormat(
Excel.XlFixedFormatType.xlTypePDF,
@"c:\myWorksheet",
Excel.XlFixedFormatQuality.xlQualityStandard,
true,
true,
1,
10,
false);
}
Private Sub SaveWorksheetAsPDF()
Dim mySheet As Microsoft.Office.Tools.Excel.WorksheetBase = Globals.Sheet1
mySheet.ExportAsFixedFormat( _
Excel.XlFixedFormatType.xlTypePDF, _
"c:\myWorksheet", _
Excel.XlFixedFormatQuality.xlQualityStandard, _
True, _
True, _
1, _
10, _
False)
End Sub
Комментарии
Этот метод также поддерживает инициализацию надстройки для экспорта файла в файл фиксированного формата. Например, Excel будет выполнять преобразование формата файла, если имеются преобразователи. Преобразование обычно инициируется пользователем.