Workbooks.Open Метод

Определение

Пространство имен:

Microsoft.Office.Interop.Excel

Сборка:

Microsoft.Office.Interop.Excel.dll

Открывает книгу.

public Microsoft.Office.Interop.Excel.Workbook Open (string Filename, object UpdateLinks, object ReadOnly, object Format, object Password, object WriteResPassword, object IgnoreReadOnlyRecommended, object Origin, object Delimiter, object Editable, object Notify, object Converter, object AddToMru, object Local, object CorruptLoad);

Public Function Open (Filename As String, Optional UpdateLinks As Object, Optional ReadOnly As Object, Optional Format As Object, Optional Password As Object, Optional WriteResPassword As Object, Optional IgnoreReadOnlyRecommended As Object, Optional Origin As Object, Optional Delimiter As Object, Optional Editable As Object, Optional Notify As Object, Optional Converter As Object, Optional AddToMru As Object, Optional Local As Object, Optional CorruptLoad As Object) As Workbook

Параметры

Filename

String

Обязательный атрибут типа String. Имя файла открываемой книги.

UpdateLinks

Object

Необязательный объект. Указывает способ обновления ссылок в файле. Если этот аргумент опущен, пользователю будет предложено указать, как будут обновляться ссылки. В противном случае этот аргумент является одним из значений, перечисленных в следующей таблице. Если Microsoft Excel открывает файл в формате WKS, WK1 или WK3 и UpdateLinks аргумент имеет значение 2, Microsoft Excel создает диаграммы из диаграмм, присоединенных к файлу. Если аргумент равен 0, диаграммы не создаются.

ReadOnly

Object

Необязательный объект. Значение true, чтобы открыть книгу в режиме только для чтения.

Format

Object

Необязательный объект. Если Microsoft Excel открывает текстовый файл, этот аргумент задает символ разделителя, как показано в следующей таблице. Если этот аргумент опущен, используется текущий разделитель.

Password

Object

Необязательный объект. Строка, содержащая пароль, необходимый для открытия защищенной книги. Если этот аргумент опущен, а для книги требуется пароль, пользователю будет предложено ввести пароль.

WriteResPassword

Object

Необязательный объект. Строка, содержащая пароль, необходимый для записи в книгу, зарезервированную для записи. Если этот аргумент опущен, а книге требуется пароль, пользователю будет предложено ввести пароль.

IgnoreReadOnlyRecommended

Object

Необязательный объект. Значение true , чтобы Microsoft Excel не отображал рекомендуемое сообщение только для чтения (если книга была сохранена с параметром "Только для чтения рекомендуется ").

Origin

Object

Необязательный объект. Если файл является текстовым файлом, этот аргумент указывает, где он возник (чтобы кодовые страницы и возврат/строка каретки (CR/LF) можно было правильно сопоставить). Может быть одной из следующих XlPlatform констант: xlMacintosh, xlWindows или xlMSDOS. Если этот аргумент опущен, используется текущая операционная система.

Delimiter

Object

Необязательный объект. Если файл является текстовым файлом, а аргумент Format равен 6, этот аргумент является строкой, указывающей символ, который будет использоваться в качестве разделителя. Например, используйте Chr(9) для вкладок, "," для запятых, ";" для точки с запятой или используйте пользовательский символ. Используется только первый символ строки.

Editable

Object

Необязательный объект. Если файл является надстройкой Microsoft Excel 4.0, этот аргумент имеет значение True , чтобы открыть надстройку, чтобы она была видимым окном. Если этот аргумент имеет значение False или опущен, надстройка открывается как скрытая и не может быть раскрыта. Этот параметр не применяется к надстройкам, созданным в Microsoft Excel 5.0 или более поздней версии. Если файл является шаблоном Excel, используйте значение True , чтобы открыть указанный шаблон для редактирования, или False , чтобы открыть новую книгу на основе указанного шаблона. Значение по умолчанию — False.

Notify

Object

Необязательный объект. Если файл не удается открыть в режиме чтения и записи, этот аргумент имеет значение True , чтобы добавить файл в список уведомлений о файлах. Microsoft Excel откроет файл как доступный только для чтения, опрашивает список уведомлений о файлах, а затем уведомляет пользователя, когда файл станет доступен. Если этот аргумент имеет значение False или опущен, уведомление не запрашивается, и любые попытки открыть недоступный файл завершатся ошибкой.

Converter

Object

Необязательный объект. Индекс первого преобразователя файлов, который следует попробовать при открытии файла. Сначала выполняется попытка указанного преобразователя файлов; Если этот преобразователь не распознает файл, пробуются все остальные преобразователи. Индекс преобразователя состоит из номеров строк преобразователей, возвращаемых свойством FileConverters[Object, Object] .

AddToMru

Object

Необязательный объект. Значение true , чтобы добавить эту книгу в список недавно использовавшихся файлов. Значение по умолчанию — False.

Local

Object

Необязательный объект. Значение True сохраняет файлы на языке Microsoft Excel (включая параметры панели управления). Значение False (по умолчанию) сохраняет файлы на языке Visual Basic для приложений (VBA) (обычно это английский язык США, если проект VBA, из которого выполняется Workbooks.Open, не является старым международным проектом VBA XL5/95).

CorruptLoad

Object

Необязательный объект. Может быть одной из следующих констант: xlNormalLoad, xlRepairFile и xlExtractData. Поведение по умолчанию, если значение не указано, обычное, но может быть безопасной загрузкой или восстановлением данных, если Excel уже пытался открыть файл. Первая попытка является нормальной. Если Excel перестает работать при открытии файла, вторая попытка является безопасной загрузкой. Если Excel снова перестает работать, следующая попытка — восстановление данных.

Возвращаемое значение

Workbook

Комментарии

По умолчанию макросы включены при открытии файлов программным способом. Используйте свойство , AutomationSecurity чтобы задать режим безопасности макросов, используемый при программном открытии файлов.