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

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

Синтаксис

void RenameMainFile(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.RenameMainFile(document, document.Files.First(t => t.FileType = DocumentFileType.Main), "Новое имя файла.docx"); (4)
1 Инициализация контекста объектов.
2 Получение сервиса.
3 Получение документа с основным файлом.
4 Изменение названия первого основного файла.

Можно указывать новое название файла без расширения, а расширение получать из оригинального файла, например, так:

DocumentFile firstMainFile = document.Files.First(t => t.FileType = DocumentFileType.Main);
string newFileName = string.Format("Новое название файла{0}", Path.GetExtension(firstMainFile.FileName));