FileContainer - класс

Контейнер, содержащий все доступные файлы.

Definition

Пространство имён: Tessa.Files
Сборка: Tessa (в Tessa.dll) Версия: 4.0.4
C#
public class FileContainer : NotificationObject, 
	IFileContainer, INotifyPropertyChanged
Inheritance
Object    NotificationObject    FileContainer
Derived
Implements
INotifyPropertyChanged, IFileContainer

Заметки

Реализация INotifyPropertyChanged требуется для того, чтобы не возникало утечек памяти при взаимодействии с UI.

Конструкторы

FileContainer Создаёт экземпляр класса с указанием значений его свойств.

Свойства

Files Коллекция файлов, доступных в контейнере.
Info Дополнительная информация по объекту, доступная для установки в расширениях. Сохраняемая информация может быть несериализуемой, например, можно записать ссылки на модели представлений или любые другие объекты.
Permissions Разрешения, доступные для контейнера с файлами.
Source Источник файлов, обеспечивающий способ их создания по умолчанию.

Методы

EqualsDetermines whether the specified object is equal to the current object.
(Унаследован от Object)
FinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Унаследован от Object)
GetHashCodeServes as the default hash function.
(Унаследован от Object)
GetTypeGets the Type of the current instance.
(Унаследован от Object)
MemberwiseCloneCreates 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)
ToStringReturns a string that represents the current object.
(Унаследован от Object)

События

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

Методы расширения

AddVirtualAsync Создаёт и добавляет виртуальный файл, возвращает созданный файл. Этот метод добавляет файл в источник по умолчанию Source для контейнера container.
(Определяется FileExtensions)
AddVirtualAsync Создаёт и добавляет виртуальный файл, возвращает созданный файл. Этот метод добавляет файл в указанный источник fileSource, что позволяет, например, добавить файл в структуру карточки CardFile, с которой не связан контейнер файлов container.
(Определяется FileExtensions)
BuildFile

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

По умолчанию файл создаётся с использованием источника Source, заданного в контейнере.

На возвращаемом объекте IFileBuilder необходимо вызвать один из методов установки контента SetContent.


(Определяется FileExtensions)
Get
(Определяется ComHelper)
Invoke
(Определяется ComHelper)
Set
(Определяется ComHelper)
SetFilePreviewAction Устанавливает метод, определяющий параметры предпросмотра файла с конвертацией. Метод вызывается при предпросмотре файлов, у которых ещё не выполнена конвертация, т.е. не установлен отдельный объект PreviewContent, но при этом текущее содержимое [!:IFile.Content] не отмечено, как изменённое IsDirty. Если файл был открыт на редактирование (отображается жёлтым), то стандартный предпросмотр для него отключён.
(Определяется FileUIExtensions)
SetNewFileAction Устанавливает метод, определяющий параметры файла, добавляемого специальным образом. Метод вызывается при добавлении файлов в специальных случаях, таких как создание файла по шаблону и сохранение многостраничного документа из окна сканирования. Метод не вызывается при типовой загрузке файлов через меню контрола или буфер обмена.
(Определяется FileUIExtensions)
SetNewPhysicalFileAction Устанавливает метод, определяющий параметры файла, добавляемого по заданному пути на диске. Метод вызывается при добавлении файлов в типовых сценариях (функция "Загрузить файлы", вставка из буфера обмена, drag&drop). Для специальных случаев, таких как создание файла по шаблону или добавление из окна сканирования, используйте методы SetNewFileAction.
(Определяется FileUIExtensions)
TryGetFile Возвращает файл, полученный по заданному идентификатору ID, или null, если подходящий файл не был найден.
(Определяется FileExtensions)
TryGetFile Возвращает файл, полученный по заданному имени Name, или null, если подходящий файл не был найден.
(Определяется FileExtensions)
TryGetFilePreviewAction Возвращает метод, определяющий параметры предпросмотра файла с конвертацией, или null, если такой метод отсутствует. Метод должен быть выполнен с указанием текущего контекста Current. Метод вызывается при предпросмотре файлов, у которых ещё не выполнена конвертация, т.е. не установлен отдельный объект PreviewContent, но при этом текущее содержимое [!:IFile.Content] не отмечено, как изменённое IsDirty. Если файл был открыт на редактирование (отображается жёлтым), то стандартный предпросмотр для него отключён.
(Определяется FileUIExtensions)
TryGetNewFileAction Возвращает метод, определяющий параметры файла, добавляемого специальным образом, или null, если такой метод отсутствует. Метод должен быть выполнен с указанием текущего контекста Current. Метод вызывается при добавлении файлов в специальных случаях, таких как создание файла по шаблону и сохранение многостраничного документа из окна сканирования. Метод не вызывается при типовой загрузке файлов через меню контрола или буфер обмена.
(Определяется FileUIExtensions)
TryGetNewPhysicalFileAction Возвращает метод, определяющий параметры файла, добавляемого по заданному пути на диске, или null, если такой метод отсутствует. Метод должен быть выполнен с указанием текущего контекста Current. Метод вызывается при добавлении файлов в типовых сценариях (функция "Загрузить файлы", вставка из буфера обмена, drag&drop). Для специальных случаев, таких как создание файла по шаблону или добавление из окна сканирования, используйте методы TryGetNewFileAction.
(Определяется FileUIExtensions)

См. также