public class File : FileObject, IFile, IFileObject,
IFileEntity, IEquatable<IFileEntity>, INotifyPropertyChanged, IEquatable<IFileObject>,
IEquatable<IFile>
Public Class File
Inherits FileObject
Implements IFile, IFileObject, IFileEntity, IEquatable(Of IFileEntity),
INotifyPropertyChanged, IEquatable(Of IFileObject), IEquatable(Of IFile)
public ref class File : public FileObject,
IFile, IFileObject, IFileEntity, IEquatable<IFileEntity^>,
INotifyPropertyChanged, IEquatable<IFileObject^>, IEquatable<IFile^>
type File =
class
inherit FileObject
interface IFile
interface IFileObject
interface IFileEntity
interface IEquatable<IFileEntity>
interface INotifyPropertyChanged
interface IEquatable<IFileObject>
interface IEquatable<IFile>
end
File | Создаёт экземпляр класса с указанием значений его свойств. |
Cancellation |
Объект, который может использоваться для отмены асинхронных операций с файлом или версией файла, которые поддерживают отмену.
На текущий момент это доступно для загрузки содержимого версии файла.
(Унаследован от FileObject) |
Category | Категория файла или null, если файл не имеет категории. |
Content |
Контент файла или версии файла. Контент файла обычно равен контенту его последней версии,
но имя файла на файловой системе может отличаться.
(Унаследован от FileObject) |
ContentState |
Состояние загрузки контента файла или версии файла в кэш для последующего отображения пользователю.
(Унаследован от FileObject) |
Created | Дата и время создания файла. |
CreatedByID | Идентификатор пользователя, создавшего файл. |
CreatedByName | Имя пользователя, создавшего файл. |
Hash |
Хеш контента файла или версии файла, или null, если хеш не вычислен.
Хеш является необязательным свойством, которое по умолчанию не заполняется системой.
(Унаследован от FileObject) |
ID |
Идентификатор объекта.
(Унаследован от FileEntity) |
Info |
Дополнительная информация, используемая в расширениях.
(Унаследован от FileObject) |
InitialState | Изначальное состояние файла. |
IsLocal | Признак того, что файл был загружен локально и отсутствует во внешней подсистеме. Значение используется при просмотре превью или при открытии файла, только что добавленного в элемент управления и не существующего на сервере. |
Modified | Дата и время последнего изменения файла. |
ModifiedByID | Идентификатор пользователя, изменившего файл. |
ModifiedByName | Имя пользователя, изменившего файл. |
Name |
Имя файла или версии файла, которое является допустимым именем файла на файловой системе,
но может отличаться от отображаемого имени файла.
(Унаследован от FileObject) |
NewVersionTags | Список тегов, связанных с добавляемой версией файла, т.е. при изменении содержимого файла в случае замены, редактирования и др. Сериализуются в карточке в форме строки. |
Options |
Настройки файла или версии файла. Сериализуются в карточке в форме JSON.
(Унаследован от FileObject) |
Origin | Исходный файл, из которого был скопирован текущий файл, или null, если текущий файл не был скопирован. |
Permissions | Разрешения на действия с файлом. |
PreviewContent | Содержимое файла, отображаемое для предпросмотра. По умолчанию значение равно Content, но оно может быть переопределено. Рекомендуется создавать такой контент из кэша, например: file.AllocateAdditionalLocalContent("filename.txt"). Возвращаемое значение не равно null. |
RequestInfo |
Дополнительная пользовательская информация, передаваемая в запросы к серверу,
которые относятся к загрузке содержимого файла/версии, к загрузке списка версий файла или к загрузке списка подписей.
(Унаследован от FileObject) |
Size |
Размер файла или версии файла в байтах. Устанавливается при создании объекта и затем обновляется
в зависимости от действительного размера контента Size.
Значение UnknownSize определяет, что размер неизвестен.
(Унаследован от FileObject) |
Source |
Объект, обеспечивающий взаимодействие текущего объекта с подсистемой,
в которой он был создан, например, с карточкой.
(Унаследован от FileEntity) |
Type | Тип файла. |
Versions | Список версий файла. Коллекция может быть пустой, если информация по версиям ещё не была запрошена. |
Equals(IFile) | Indicates whether the current object is equal to another object of the same type. |
Equals(IFileEntity) | Indicates whether the current object is equal to another object of the same type. (Унаследован от FileEntity) |
Equals(IFileObject) | Indicates whether the current object is equal to another object of the same type. (Унаследован от FileObject) |
Equals(Object) | Determines whether the specified object is equal to the current object. (Унаследован от FileEntity) |
Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Унаследован от Object) |
GetHashCode | Serves as the default hash function. (Унаследован от FileEntity) |
GetState | Возвращает текущее состояние файла. |
GetStateCore | Возвращает текущее состояние файла. |
GetType | Gets the Type of the current instance. (Унаследован от Object) |
HasChanges | Возвращает признак того, что заданное состояние файла отличается от его текущего состояния. |
HasChangesCore | Возвращает признак того, что заданное состояние файла отличается от его текущего состояния. |
InvalidateContentAsync |
Удаляет локально загруженный контент, переводя его в начальное состояние.
Следующий раз при получении контента он будет заново загружен.
(Унаследован от FileObject) |
MemberwiseClone | Creates a shallow copy of the current Object. (Унаследован от Object) |
OnContentPropertyChanged |
Обработчик события на изменение свойства для контента текущего объекта Content.
(Унаследован от FileObject) |
OnPropertyChanged(PropertyChangedEventArgs) |
Уведомляет об изменении свойства с именем, заданным в аргументах события.
(Унаследован от NotificationObject) |
OnPropertyChanged(String) |
Уведомляет об изменении свойства с заданным именем у объекта.
(Унаследован от NotificationObject) |
OnPropertyChangedAsync(PropertyChangedEventArgs, Boolean) |
Уведомляет об изменении свойства с именем, заданным в аргументах события, асинхронно, в соответствии
с принятым для текущего объекта поведением. Если есть возможность вызвать событие синхронно, то оно вызывается синхронно.
Если объект является моделью представления WPF и текущий поток отличен от потока диспетчера WPF для приложения
(основной поток UI), то выполнение асинхронно переключается в этот поток. Если это не так, то событие выполняется синхронно.
(Унаследован от NotificationObject) |
OnPropertyChangedAsync(String, Boolean) |
Уведомляет об изменении свойства с заданным именем у объекта асинхронно, в соответствии
с принятым для текущего объекта поведением. Если есть возможность вызвать событие синхронно, то оно вызывается синхронно.
Если объект является моделью представления WPF и текущий поток отличен от потока диспетчера WPF для приложения
(основной поток UI), то выполнение асинхронно переключается в этот поток. Если это не так, то событие выполняется синхронно.
(Унаследован от NotificationObject) |
SetCategoryAsync | Устанавливает категорию файла или null, если файл не имеет категории. |
SetContentStateAsync |
Устанавливает состояние загрузки контента файла или версии файла в кэш для последующего отображения пользователю.
(Унаследован от FileObject) |
SetCreatedAsync | Устанавливает дату и время создания файла. |
SetCreatedByIDAsync | Устанавливает идентификатор пользователя, создавшего файл. |
SetCreatedByNameAsync | Устанавливает имя пользователя, создавшего файл. |
SetHashAsync |
Устанавливает хеш контента файла или версии файла, или null, если хеш не вычислен.
Хеш является необязательным свойством, которое по умолчанию не заполняется системой.
(Унаследован от FileObject) |
SetInitialStateAsync | Устанавливает тип файла. |
SetModifiedAsync | Устанавливает дату и время последнего изменения файла. |
SetModifiedByIDAsync | Устанавливает идентификатор пользователя, изменившего файл. |
SetModifiedByNameAsync | Устанавливает имя пользователя, изменившего файл. |
SetNameAsync |
Устанавливает имя файла или версии файла, которое является допустимым именем файла на файловой системе,
но может отличаться от отображаемого имени файла.
(Унаследован от FileObject) |
SetOriginAsync | Устанавливает исходный файл, из которого был скопирован текущий файл, или null, если текущий файл не был скопирован. |
SetPreviewContentAsync | Устанавливает содержимое файла, отображаемое для предпросмотра. По умолчанию значение равно Content, но оно может быть переопределено. Рекомендуется создавать такой контент из кэша, например: file.AllocateAdditionalLocalContent("filename.txt"). |
SetSizeAsync |
Устанавливает размер файла или версии файла в байтах.
(Унаследован от FileObject) |
SetStateAsync | Устанавливает текущее состояние файла, равное заданному состоянию. |
SetStateCoreAsync | Устанавливает текущее состояние файла, равное заданному состоянию. |
SetTypeAsync | Устанавливает тип файла. |
ToString | Returns a string that represents the current object. (Унаследован от FileObject) |
UpdateInitialStateAsync | Обновляет начальное состояние файла и устанавливаем его как равное заданному состоянию. Не рекомендуется вызывать этот метод для существующих файлов, которые уже мог отредактировать пользователь. |
UpdateInitialStateCoreAsync | Обновляет начальное состояние файла и устанавливаем его как равное заданному состоянию. Не рекомендуется вызывать этот метод для существующих файлов, которые уже мог отредактировать пользователь. |
PropertyChanged | Событие, уведомляющее об изменении свойства с определённым именем у модели представления. (Унаследован от NotificationObject) |
AllocateAdditionalLocalContentAsync |
Создаёт дополнительный объект локального содержимого (на диске) для файла или версии файла.
Загрузка такого содержимого отменяется вместе с основным содержимым.
(Определяется FileExtensions) |
CancelDownloadingContent |
Отменяет асинхронную загрузку содержимого файла или версии. При отмене загрузки файла
также отменяется загрузка всех его версий.
(Определяется FileExtensions) |
ChangeCategoryAsync |
Изменяет категорию файла и уведомляет об этом его источник,
если категория в действительности изменилась.
(Определяется FileExtensions) |
ChangeCategoryAsync |
Изменяет категорию файла без указания идентификатора категории.
(Определяется FileExtensions) |
ChangeCategoryAsync |
Изменяет категорию файла с указанием идентификатора категории.
(Определяется FileExtensions) |
CopyAsync |
Создаёт копию заданного файла. Если контент копируемого файла не загружен, то он загружается перед созданием копии.
Первым значением возвращается копия заданного файла или null, если копию создать не удалось.
В этом случае возвращённый результат валидации не будет успешным.
(Определяется FileExtensions) |
EnsureContentDownloadedAsync |
Загружает контент файла или версии файла, если он ещё не был загружен.
На загруженном контенте вызывается метод EnsureLocalUpdatedAsync(CancellationToken).
(Определяется FileExtensions) |
EnsureContentDownloadedInUIAsync | Загружает контент файла или версии файла, если он ещё не был загружен. На загруженном контенте вызывается метод EnsureLocalUpdatedAsync(CancellationToken). Изменение состояния контента выполняется в основном потоке UI, если выполнение производится на клиенте, и в текущем потоке, если выполнение производится посредством серверного API. (Определяется FileExtensions) |
EnsureContentModifiedAsync |
Проверяет, что источник файла был уведомлён об изменениях,
сделанных для контента файла Content.
(Определяется FileExtensions) |
EnsureVersionsLoadedAsync |
Загружает версии файла, если они ещё не были загружены.
(Определяется FileExtensions) |
Get | (Определяется ComHelper) |
GetActionName |
Возвращает имя действия, в рамках которого был создан файл или версия файла,
или null, если файл не был создан специальным способом.
(Определяется FileExtensions) |
GetLinkAsync |
Возвращает ссылку на файл.
(Определяется FileExtensions) |
GetRootedOrigin |
Возвращает корневой элемент в дереве файлов, связанных посредством свойства Origin,
или null, если значение свойства Origin для файла file
равно null.
(Определяется FileExtensions) |
Invoke | (Определяется ComHelper) |
IsLarge |
Возвращает признак того, что содержимое версии файла считается большим файлом, поэтому будет обрабатываться особым образом.
Проверка выполняется по наличию тега Large.
(Определяется FileExtensions) |
IsValidForContentOperations |
Возвращает признак того, что заданный объект (файл или версия файла)
может участвовать в операциях, связанных с контентом. Обычно это означает,
что при загрузке контента не возникло ошибок и контент полностью загружен на сервер
(не находится в процессе загрузки). При этом на клиент контент мог ещё не быть загружен,
т.е. потребуется вызвать EnsureContentDownloadedAsync(IFileObject, FuncIFileObject, FileContentDownloadState, FuncFileContentDownloadState, CancellationToken, ValueTask, FuncIFileObject, CancellationToken, ValueTaskIFileContent, CancellationToken).
(Определяется FileExtensions) |
NotifyAsync |
Уведомляет источник заданного файла IFileSource о возникшем событии FileNotificationType.
Используйте при изменении свойств файла вручную, чтобы эти свойства были сохранены в пакете карточки (если файл связан с карточкой).
(Определяется FileExtensions) |
OpenAsync |
Открывает контент заданного файла или версии файла для чтения или для редактирования.
(Определяется FileExtensions) |
OpenInFolderAsync |
Открывает контент заданного файла или версии файла для чтения или для редактирования в окне проводника.
(Определяется FileExtensions) |
ReadAllBytesAsync | Возвращает контент файла или версии файла в виде массива байт. Контент должен быть уже загружен методом EnsureContentDownloadedAsync(IFileObject, FuncIFileObject, FileContentDownloadState, FuncFileContentDownloadState, CancellationToken, ValueTask, FuncIFileObject, CancellationToken, ValueTaskIFileContent, CancellationToken) или EnsureContentDownloadedInUIAsync(IFileObject, FuncIFileObject, CancellationToken, ValueTaskIFileContent, CancellationToken). Этот метод оптимизирован по потреблению памяти, поэтому для получения данных рекомендуется использовать именно его. (Определяется FileExtensions) |
ReadAllTextAsync | Возвращает контент текстового файла или версии файла в виде строки. Контент должен быть уже загружен методом EnsureContentDownloadedAsync(IFileObject, FuncIFileObject, FileContentDownloadState, FuncFileContentDownloadState, CancellationToken, ValueTask, FuncIFileObject, CancellationToken, ValueTaskIFileContent, CancellationToken) или EnsureContentDownloadedInUIAsync(IFileObject, FuncIFileObject, CancellationToken, ValueTaskIFileContent, CancellationToken). Этот метод оптимизирован по потреблению памяти, поэтому для получения данных рекомендуется использовать именно его. (Определяется FileExtensions) |
ReadBase64Async |
Возвращает контент файла или версии файла в виде строки формата base64. Контент должен быть уже загружен методом
EnsureContentDownloadedAsync(IFileObject, FuncIFileObject, FileContentDownloadState, FuncFileContentDownloadState, CancellationToken, ValueTask, FuncIFileObject, CancellationToken, ValueTaskIFileContent, CancellationToken) или EnsureContentDownloadedInUIAsync(IFileObject, FuncIFileObject, CancellationToken, ValueTaskIFileContent, CancellationToken).
(Определяется FileExtensions) |
RenameAsync |
Переименовывает файл с уведомлением его источника, если имя изменилось.
(Определяется FileExtensions) |
ReplaceAsync |
Заменяет содержимое файла на заданный массив байт.
(Определяется FileExtensions) |
ReplaceAsync |
Заменяет контент заданного файла на контент из заданного потока.
(Определяется FileExtensions) |
ReplaceAsync |
Заменяет контент заданного файла на контент, определяемый заданными функциями.
(Определяется FileExtensions) |
ReplaceAsync |
Заменяет контент заданного файла на контент файла с указанным именем.
Если отличается не только путь к указанному файлу, но и имя,
а также параметр changeName равен true,
то имя файла также будет изменено.
(Определяется FileExtensions) |
ReplaceTextAsync |
Заменяет содержимое файла на заданный текст с указанием кодировки.
Содержимое файла будет сохранено во временной папке и доступно для пользователя в UI.
(Определяется FileExtensions) |
RestoreDownloadingContentAfterCancel |
Восстанавливает возможность асинхронной загрузки содержимого файла или версии после отмены.
При восстановлении загрузки файла также восстанавливается загрузка всех его версий.
(Определяется FileExtensions) |
RevertAsync |
Восстанавливает контент и имя файла к виду до его изменения.
(Определяется FileExtensions) |
SaveAsync |
Сохраняет контент заданного файла или версии файла в файле с указанным именем.
(Определяется FileExtensions) |
SaveAsync |
Сохраняет контент заданного файла или версии файла в файле с указанным именем.
(Определяется FileExtensions) |
Set | (Определяется ComHelper) |
SetActionName |
Устанавливает имя действия, в рамках которого был создан файл или версия файла.
Например: FileMenuActionNames.Scan или FileMenuActionNames.AddFromTemplate.
(Определяется FileExtensions) |
TryGetActualFile |
Возвращает объект IFile, соответствующей переданному файлу или файлу переданной версии.
Возвращает null, если переданный объект не является файлом IFile или версией IFileVersion.
(Определяется FileExtensions) |
TryGetActualVersion |
Возвращает объект IFileVersion, соответствующей переданной версии или последней версии переданного файла.
Возвращает null, если переданный объект не является файлом IFile или версией IFileVersion.
(Определяется FileExtensions) |