IDocumentService.RenameAdditionalFile — метод (Document, DocumentFile, String)

Переименовывает дополнительный файл документа.

Синтаксис

void RenameAdditionalFile(Document document, DocumentFile file, string newFileName)
Параметры
document

Тип: Document

Документ, которому принадлежит файл

file

Тип: DocumentFile

Файл, название которого изменяется

newFileName

Тип: System.String

Новое название файла. Имя файла должно содержать расширение.

Исключения

Исключение Условие

System.ArgumentNullException

Ошибка возвращается в случае, если не задан параметр document, file или newFileName.

System.ArgumentException

Ошибка возвращается, если 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));