IDocumentService.RenameAdditionalFile — метод (Document, DocumentFile, String)
Переименовывает дополнительный файл документа.
-
Пространство имён:
DocsVision.BackOffice.ObjectModel.Services
-
Сборка:
DocsVision.BackOffice.ObjectModel.dll
Синтаксис
void RenameAdditionalFile(Document document, DocumentFile file, string newFileName)
- Параметры
-
- document
-
Тип:
Document
Документ, которому принадлежит файл
- file
-
Тип:
DocumentFile
Файл, название которого изменяется
- newFileName
-
Тип:
System.String
Новое название файла. Имя файла должно содержать расширение.
Исключения
Исключение | Условие |
---|---|
Ошибка возвращается в случае, если не задан параметр |
|
Ошибка возвращается, если newFileName содержит только символы-разделители, либо содержит недопустимые ( |
Заметки
Чтобы сотрудник мог переименовывать файлы документа, ему должны быть предоставлены права в ролевой модели безопасности: Переименование файлов и Запись.
Примеры
(1)
IDocumentService documentService = objectContext.GetService<IDocumentService>(); (2)
Document document = objectContext.GetObject<Document>(new Guid("00000000-0000-0000-0000-000000000000")); (3)
documentService.RenameAdditionalFile(document, document.Files.First(t => t.FileType = DocumentFileType.Additional), "Новое имя файла.docx"); (4)
1 | Инициализация контекста объектов. |
2 | Получение сервиса. |
3 | Получение документа с дополнительным файлом. |
4 | Изменение названия первого дополнительного файла. |
Можно указывать новое название файла без расширения, а расширение получать из оригинального файла, например, так:
DocumentFile firstAdditionalFile = document.Files.First(t => t.FileType = DocumentFileType.Additional);
string newFileName = string.Format("Новое название файла{0}", Path.GetExtension(firstAdditionalFile.FileName));