public class RemoteFileContent : FileContentPublic Class RemoteFileContent
Inherits FileContentpublic ref class RemoteFileContent : public FileContenttype RemoteFileContent =
class
inherit FileContent
end| RemoteFileContent | Создаёт контент с указанием используемых функций. После вызова конструктора объекта требуется инициализировать методом InitializeAsync(CancellationToken). |
| Cancellation |
Объект, который может использоваться для отмены асинхронных операций с содержимым файла, если оно поддерживает отмену.
На текущий момент это доступно для загрузки содержимого версии файла.
(Унаследован от FileContent) |
| GetContentFuncAsync | Функция, открывающая и возвращающая поток с данными. Не равна null. |
| GetSizeFuncAsync | Функция, возвращающая размер потока с данными GetContentFuncAsync. Не равна null. |
| HasCurrentContentData |
Данные для получения контента всегда присутствуют. При получении значения свойство возвращает true.
При установке значения не выполняется действий.
(Переопределяет FileContentHasCurrentContentData) |
| HasData |
Возвращает признак того, что контент файла был установлен методом [IFileContent.Set].
(Унаследован от FileContent) |
| IsBoundToFileSource |
Признак того, что контент был создан источником файлов, а не передан снаружи, поэтому для оптимизации обращения к содержимому
можно использовать источник файлов. Обычно актуально для Remote-контента.
(Переопределяет FileContentIsBoundToFileSource) |
| IsDirty |
Признак того, что контент мог быть изменён. Следует установить значение равным true
перед открытием контента на редактирование во внешней программе.
Определить точно, был ли изменён контент, можно, вызвав метод [IFileContent.IsModified].
(Унаследован от FileContent) |
| IsDisposed | Признак того, что контент был освобождён и объект нельзя использовать. (Унаследован от FileContent) |
| IsLocal |
Признак того, что контент является локальным, т.е. к нему можно получить локальный путь
посредством метода [IFileContent.GetLocalFilePath].
(Переопределяет FileContentIsLocal) |
| IsSealed | Признак того, что объект был защищён от изменений. (Унаследован от FileContent) |
| Parent |
Родительский контент или null, если родительский контент отсутствует.
Если производится запрос текущего контента, и он не был установлен,
то он сначала локально копируется из родительского, если тот существует,
а затем считывается локально.
(Унаследован от FileContent) |
| RequestInfo |
Дополнительная пользовательская информация, передаваемая в запросы к серверу,
которые относятся к загрузке содержимого файла или версии, которые сохраняются в текущем объекте.
Рекомендуется, чтобы все данные были сериализуемых типов (в соответствии с типовой BSON-сериализацией в системе).
Такие данные могут перезаписать данные из [IFileObject.RequestInfo].
(Унаследован от FileContent) |
| Size |
Размер контента файла в байтах или 0, если контент ещё не был загружен.
Проверить, был ли загружен контент, можно, обратившись к свойству [IFileContent.HasData].
(Унаследован от FileContent) |
| Uri |
Ссылка к контенту файла, который может быть доступен как локально (на диске),
так и удалённо (сетевой ресурс). Значение может быть равно null, если контент недоступен по ссылке.
(Переопределяет FileContentUri) |
| CheckDisposed |
Выбрасывает исключение [ObjectDisposedException], если ресурсы текущего объекта были освобождены.
(Унаследован от FileContent) |
| CheckSealed |
Выбрасывает исключение [Tessa.Platform.ObjectSealedException],
если объект был защищён от изменений.
(Унаследован от FileContent) |
| DisposeAsync | Освобождает ресурсы, занимаемые объектом. (Унаследован от FileContent) |
| DisposeAsync(Boolean) | Освобождает ресурсы, занимаемые объектом. (Унаследован от FileContent) |
| EnsureLocalUpdatedAsync |
Удостоверяет, что файл будет загружен локально и доступен по пути [IFileContent.GetLocalFilePath],
если файл является локальным [IFileContent.IsLocal]. Если файл не локальный, то метод не выполняет действий.
(Унаследован от FileContent) |
| EnterLockAsync |
Выполняет вход в блок, в пределах которого нет других обращений к контенту файла.
Вызовите метод в блоке using(await content.EnterLockAsync().ConfigureAwait(false)).
(Унаследован от FileContent) |
| Equals | Determines whether the specified object is equal to the current object. (Унаследован от Object) |
| Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Унаследован от Object) |
| FromContentAsync | Создаёт объект контента файла, содержимое и размер которого определяются по заданному объекту контента content. |
| FromFilePathAsync | Создаёт объект контента файла, который соответствует заданному файлу, доступному по полному пути на диске filePath. |
| FromStreamAndSizeAsync | Создаёт объект контента файла, который может быть получен по заданному функции getContentFuncAsync и имеет фиксированный (заранее вычисленный) размер. Если размер не является фиксированным, то следует использовать конструктор RemoteFileContent/ |
| GetAsync |
Открывает и возвращает поток с контентом файла.
Если контент файла отсутствует, то вызывает исключение [System.InvalidOperationException].
Поэтому перед получением контента можно обратиться к свойству [IFileContent.HasData].
(Унаследован от FileContent) |
| GetCoreAsync |
Возвращает поток с содержимым файла.
Если файл не был загружен, то может быть выброшено исключение.
(Переопределяет FileContentGetCoreAsync(CancellationToken)) |
| GetHashCode | Serves as the default hash function. (Унаследован от Object) |
| GetLocalFilePath |
Возвращает локальный путь к контенту файла, если контент доступен локально.
Если контент не доступен локально, то вызывает исключение [System.InvalidOperationException].
Поэтому перед вызовом метода можно обратиться к свойству [IFileContent.IsLocal].
(Унаследован от FileContent) |
| GetLocalFilePathCore |
Возвращает путь к файлу с локальным контентом, даже если он ещё не был загружен,
или null, если контент не представлен локальным файлом.
(Переопределяет FileContentGetLocalFilePathCore) |
| GetType | Gets the Type of the current instance. (Унаследован от Object) |
| InitializeAsync | Выполняет асинхронную инициализацию объекта. (Унаследован от FileContent) |
| InvalidateAsync |
Удаляет локально загруженный контент, переводя его в начальное состояние.
Следующий раз при получении контента он будет заново загружен.
(Унаследован от FileContent) |
| InvalidateCoreAsync |
Сбрасывает информацию о контенте файла. Например, очищает дату изменения файла.
Если контент не является локальным, то может не выполнять действий.
(Переопределяет FileContentInvalidateCoreAsync(CancellationToken)) |
| IsModifiedAsync |
Возвращает признак того, что контент файла на диске был изменён с момента его
установки методом [IFileContent.Set].
Для защищённых от изменений объектов метод всегда возвращает false.
(Унаследован от FileContent) |
| IsModifiedCoreAsync |
Возвращает признак того, что локальный контент был изменён.
Например, был изменён файл на диске по дате изменения.
При изменении контента может быть обновлён его размер,
а также он может быть, например, помечен как изменённый в структуре карточки.
(Переопределяет FileContentIsModifiedCoreAsync(CancellationToken)) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Унаследован от Object) |
| OnPropertyChanged(PropertyChangedEventArgs) |
Уведомляет об изменении свойства с именем, заданным в аргументах события.
(Унаследован от NotificationObject) |
| OnPropertyChanged(String) |
Уведомляет об изменении свойства с заданным именем у объекта.
(Унаследован от NotificationObject) |
| OnPropertyChangedAsync(PropertyChangedEventArgs, Boolean) |
Уведомляет об изменении свойства с именем, заданным в аргументах события, асинхронно, в соответствии
с принятым для текущего объекта поведением. Если есть возможность вызвать событие синхронно, то оно вызывается синхронно.
Если объект является моделью представления WPF и текущий поток отличен от потока диспетчера WPF для приложения
(основной поток UI), то выполнение асинхронно переключается в этот поток. Если это не так, то событие выполняется синхронно.
(Унаследован от NotificationObject) |
| OnPropertyChangedAsync(String, Boolean) |
Уведомляет об изменении свойства с заданным именем у объекта асинхронно, в соответствии
с принятым для текущего объекта поведением. Если есть возможность вызвать событие синхронно, то оно вызывается синхронно.
Если объект является моделью представления WPF и текущий поток отличен от потока диспетчера WPF для приложения
(основной поток UI), то выполнение асинхронно переключается в этот поток. Если это не так, то событие выполняется синхронно.
(Унаследован от NotificationObject) |
| PrepareContentLocationCoreAsync |
Подготавливает местоположение контента перед его записью или перемещением в это местоположение.
Например, создаёт папку на диске, если контент представлен файлом на диске.
(Переопределяет FileContentPrepareContentLocationCoreAsync(CancellationToken)) |
| RemoveContentSafeCoreAsync |
Метод удаляет локальный контент, если он был создан.
Если контент не является локальным, то метод не должен выполнять действий.
Метод не должен выбрасывать исключений, даже критичных.
(Переопределяет FileContentRemoveContentSafeCoreAsync(CancellationToken)) |
| RenameAsync |
Переименовывает файл, в который записывается контент.
Если файл ещё не существует, то он будет назван по-другому в момент создания.
Метод гарантированно сработает только в том случае, если контент является локальным,
т.е. свойство [IFileContent.IsLocal] возвращает true.
(Унаследован от FileContent) |
| RenameCoreAsync |
Переименовывает имя контента в соответствии с новым именем файла.
Если контент представлен локальным файлом на диске, то метод должен переименовать этот файл.
Если контент не является локальным, то метод может не выполнять действий.
(Переопределяет FileContentRenameCoreAsync(String, CancellationToken)) |
| Seal | Защищает объект от изменений. (Унаследован от FileContent) |
| SetAsync | Открывает и возвращает поток, выполняющий перезапись контента файла. (Унаследован от FileContent) |
| SetCoreAsync |
Устанавливает содержимое файла. Если контент запрещено изменять, то может быть выброшено исключение.
(Переопределяет FileContentSetCoreAsync(Stream, CancellationToken)) |
| SetLocalAsync | Устанавливает контент локального файла по заданному пути. (Унаследован от FileContent) |
| SetLocalCoreAsync |
Устанавливает локальное содержимое файла, представленное в виде файла на диске, по заданному методу,
который получает в параметре путь к файлу на диске и может его создать или изменить некоторым способом.
Если содержимое файла не является локальным, то может быть выброшено исключение.
(Переопределяет FileContentSetLocalCoreAsync(FuncString, CancellationToken, ValueTask, CancellationToken)) |
| SetRemoteAsync |
Устанавливает содержимое файла, представленное заданными методами. Если контент запрещено изменять, то может быть выброшено исключение.
Метод доступен как для локальных файлов, так и для нелокальных (remote), в т.ч. для файлов большого размера.
(Унаследован от FileContent) |
| SetRemoteCoreAsync |
Устанавливает содержимое файла, представленное заданными методами. Если контент запрещено изменять, то может быть выброшено исключение.
Метод доступен как для локальных файлов, так и для нелокальных (remote), в т.ч. для файлов большого размера.
(Переопределяет FileContentSetRemoteCoreAsync(FuncCancellationToken, ValueTaskStream, FuncCancellationToken, ValueTaskInt64, CancellationToken)) |
| ToString | Returns a string that represents the current object. (Унаследован от Object) |
| UpdateLocalContentFromParentCoreAsync |
Обновляет локальный контент на основании контента родительского объекта.
При вызове этого метода гарантируется, что у текущего контента есть родительский контент,
в котором присутствуют загруженные данные.
Если контент не локальный, то метод может не выполнять действий, но не должен выбрасывать исключений.
(Переопределяет FileContentUpdateLocalContentFromParentCoreAsync(CancellationToken)) |
| UpdateModifiedCoreAsync |
Обновляет информацию, на основании которой можно определить, изменялся ли контент.
Например, сохраняет время изменения файла, чтобы его можно было сравнить
со временем изменения в любой другой момент.
(Переопределяет FileContentUpdateModifiedCoreAsync(CancellationToken)) |
| UpdateSizeAsync |
Обновляет свойство с размером контента [IFileContent.Size] для загруженных файлов.
(Унаследован от FileContent) |
| UpdateSizeCoreAsync |
Обновляет размер локального контента.
Возвращает true, если размер был обновлён.
(Переопределяет FileContentUpdateSizeCoreAsync(CancellationToken)) |
| PropertyChanged | Событие, уведомляющее об изменении свойства с определённым именем у модели представления. (Унаследован от NotificationObject) |
| Get | (Определяется ComHelper) |
| InternalMarkerCanvas |
Возвращает маркер аннотации
(Определяется AnnotationInternalsAccessor) |
| Invoke | (Определяется ComHelper) |
| Set | (Определяется ComHelper) |