RemoteFileContent - класс

Создаёт контент с указанием используемых функций. После вызова конструктора объекта требуется инициализировать методом InitializeAsync(CancellationToken).

Объект, который может использоваться для отмены асинхронных операций с содержимым файла, если оно поддерживает отмену. На текущий момент это доступно для загрузки содержимого версии файла.

Функция, открывающая и возвращающая поток с данными. Не равна null.

Функция, возвращающая размер потока с данными GetContentFuncAsync. Не равна null.

Данные для получения контента всегда присутствуют. При получении значения свойство возвращает true. При установке значения не выполняется действий.

Возвращает признак того, что контент файла был установлен методом [IFileContent.Set].

Признак того, что контент был создан источником файлов, а не передан снаружи, поэтому для оптимизации обращения к содержимому можно использовать источник файлов. Обычно актуально для Remote-контента.

Признак того, что контент мог быть изменён. Следует установить значение равным true перед открытием контента на редактирование во внешней программе. Определить точно, был ли изменён контент, можно, вызвав метод [IFileContent.IsModified].

Признак того, что контент был освобождён и объект нельзя использовать.

Признак того, что контент является локальным, т.е. к нему можно получить локальный путь посредством метода [IFileContent.GetLocalFilePath].

Признак того, что объект был защищён от изменений.

Родительский контент или null, если родительский контент отсутствует. Если производится запрос текущего контента, и он не был установлен, то он сначала локально копируется из родительского, если тот существует, а затем считывается локально.

Дополнительная пользовательская информация, передаваемая в запросы к серверу, которые относятся к загрузке содержимого файла или версии, которые сохраняются в текущем объекте. Рекомендуется, чтобы все данные были сериализуемых типов (в соответствии с типовой BSON-сериализацией в системе). Такие данные могут перезаписать данные из [IFileObject.RequestInfo].

Размер контента файла в байтах или 0, если контент ещё не был загружен. Проверить, был ли загружен контент, можно, обратившись к свойству [IFileContent.HasData].

Ссылка к контенту файла, который может быть доступен как локально (на диске), так и удалённо (сетевой ресурс). Значение может быть равно null, если контент недоступен по ссылке.

Выбрасывает исключение [ObjectDisposedException], если ресурсы текущего объекта были освобождены.

Выбрасывает исключение [Tessa.Platform.ObjectSealedException], если объект был защищён от изменений.

Освобождает ресурсы, занимаемые объектом.

Освобождает ресурсы, занимаемые объектом.

Удостоверяет, что файл будет загружен локально и доступен по пути [IFileContent.GetLocalFilePath], если файл является локальным [IFileContent.IsLocal]. Если файл не локальный, то метод не выполняет действий.

Выполняет вход в блок, в пределах которого нет других обращений к контенту файла. Вызовите метод в блоке using(await content.EnterLockAsync().ConfigureAwait(false)).

Determines whether the specified object is equal to the current object.

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

Создаёт объект контента файла, содержимое и размер которого определяются по заданному объекту контента content.

Создаёт объект контента файла, который соответствует заданному файлу, доступному по полному пути на диске filePath.

Создаёт объект контента файла, который может быть получен по заданному функции getContentFuncAsync и имеет фиксированный (заранее вычисленный) размер. Если размер не является фиксированным, то следует использовать конструктор RemoteFileContent/

Открывает и возвращает поток с контентом файла. Если контент файла отсутствует, то вызывает исключение [System.InvalidOperationException]. Поэтому перед получением контента можно обратиться к свойству [IFileContent.HasData].

Возвращает поток с содержимым файла. Если файл не был загружен, то может быть выброшено исключение.

Serves as the default hash function.

Возвращает локальный путь к контенту файла, если контент доступен локально. Если контент не доступен локально, то вызывает исключение [System.InvalidOperationException]. Поэтому перед вызовом метода можно обратиться к свойству [IFileContent.IsLocal].

Возвращает путь к файлу с локальным контентом, даже если он ещё не был загружен, или null, если контент не представлен локальным файлом.

Gets the Type of the current instance.

Выполняет асинхронную инициализацию объекта.

Удаляет локально загруженный контент, переводя его в начальное состояние. Следующий раз при получении контента он будет заново загружен.

Сбрасывает информацию о контенте файла. Например, очищает дату изменения файла. Если контент не является локальным, то может не выполнять действий.

Возвращает признак того, что контент файла на диске был изменён с момента его установки методом [IFileContent.Set]. Для защищённых от изменений объектов метод всегда возвращает false.

Возвращает признак того, что локальный контент был изменён. Например, был изменён файл на диске по дате изменения. При изменении контента может быть обновлён его размер, а также он может быть, например, помечен как изменённый в структуре карточки.

Creates a shallow copy of the current Object.

Уведомляет об изменении свойства с именем, заданным в аргументах события.

Уведомляет об изменении свойства с заданным именем у объекта.

Уведомляет об изменении свойства с именем, заданным в аргументах события, асинхронно, в соответствии с принятым для текущего объекта поведением. Если есть возможность вызвать событие синхронно, то оно вызывается синхронно. Если объект является моделью представления WPF и текущий поток отличен от потока диспетчера WPF для приложения (основной поток UI), то выполнение асинхронно переключается в этот поток. Если это не так, то событие выполняется синхронно.

Уведомляет об изменении свойства с заданным именем у объекта асинхронно, в соответствии с принятым для текущего объекта поведением. Если есть возможность вызвать событие синхронно, то оно вызывается синхронно. Если объект является моделью представления WPF и текущий поток отличен от потока диспетчера WPF для приложения (основной поток UI), то выполнение асинхронно переключается в этот поток. Если это не так, то событие выполняется синхронно.

Подготавливает местоположение контента перед его записью или перемещением в это местоположение. Например, создаёт папку на диске, если контент представлен файлом на диске.

Метод удаляет локальный контент, если он был создан. Если контент не является локальным, то метод не должен выполнять действий. Метод не должен выбрасывать исключений, даже критичных.

Переименовывает файл, в который записывается контент. Если файл ещё не существует, то он будет назван по-другому в момент создания. Метод гарантированно сработает только в том случае, если контент является локальным, т.е. свойство [IFileContent.IsLocal] возвращает true.

Переименовывает имя контента в соответствии с новым именем файла. Если контент представлен локальным файлом на диске, то метод должен переименовать этот файл. Если контент не является локальным, то метод может не выполнять действий.

Защищает объект от изменений.

Открывает и возвращает поток, выполняющий перезапись контента файла.

Устанавливает содержимое файла. Если контент запрещено изменять, то может быть выброшено исключение.

Устанавливает контент локального файла по заданному пути.

Устанавливает локальное содержимое файла, представленное в виде файла на диске, по заданному методу, который получает в параметре путь к файлу на диске и может его создать или изменить некоторым способом. Если содержимое файла не является локальным, то может быть выброшено исключение.

Устанавливает содержимое файла, представленное заданными методами. Если контент запрещено изменять, то может быть выброшено исключение. Метод доступен как для локальных файлов, так и для нелокальных (remote), в т.ч. для файлов большого размера.

Устанавливает содержимое файла, представленное заданными методами. Если контент запрещено изменять, то может быть выброшено исключение. Метод доступен как для локальных файлов, так и для нелокальных (remote), в т.ч. для файлов большого размера.

Returns a string that represents the current object.

Обновляет локальный контент на основании контента родительского объекта. При вызове этого метода гарантируется, что у текущего контента есть родительский контент, в котором присутствуют загруженные данные. Если контент не локальный, то метод может не выполнять действий, но не должен выбрасывать исключений.

Обновляет информацию, на основании которой можно определить, изменялся ли контент. Например, сохраняет время изменения файла, чтобы его можно было сравнить со временем изменения в любой другой момент.

Обновляет свойство с размером контента [IFileContent.Size] для загруженных файлов.

Обновляет размер локального контента. Возвращает true, если размер был обновлён.

Событие, уведомляющее об изменении свойства с определённым именем у модели представления.

Возвращает маркер аннотации