| Name | Description | |
|---|---|---|
 | MarkupFileImageDataProvider Constructor |
ImageGear .NET v24.12 - Updated
MarkupFileImageDataProvider Class Members
The following tables list the members exposed by MarkupFileImageDataProvider.
| Name | Description | |
|---|---|---|
| MarkupFileImageDataProvider Constructor |
| Name | Description | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
 | ArtDataFileNameFormat | Gets the Art Data File Name Format specified in Web.config for this Data Provider used to store and retrieve Markup Layers to disk. The file names of Markup Layers are significant as this Data Provider may use a directory listing of the ArtStorageRootPath and parse the file names of the documents within to obtain Markup Layer Record IDs for Markup Layers associated with a particular Document ID.
The ArtDataFileNameFormat should include all 3 format strings for the Document Identifier, Separator Token, and Markup Layer Record ID in order to be able to reliably parse the file names to obtain a listing of the Markup Layers associated with a particular Document ID. As this is a File Data Provider, the separator character must be a valid OS File Name Character, however, it is suggested that this character be reserved and not used as a part of any Document ID or Markup Layer Record ID in order to avoid ambiguity when parsing the file names and obtaining the Markup Layer List. You may alter the Markup Layer Record IDs generated through the use of Art Middleware, however, by default, Markup Layer Record IDs will be GUIDs. This structured and reliable format for Markup Layer Record IDs will reduce the likelihood of ambiguity. The last instance of SeparatorToken in the file name will be used in parsing to obtain the Document ID and Markup Layer Record ID for a given Art Document file name. The following case-insensitive format substrings can be used when specifying the Art Data File Name Format.
| ||||||||
| ArtStorageRootPath | Gets the Art Storage Root Path specified in Web.config for this Data Provider. This path is the path from which all Markup Layers are served and the path to which new Markup Layers will be stored. | ||||||||
| CachingEnable | Gets the Caching Enable value for this Data Provider specified in Web.config. This is a boolean value indicating whether or not document memory caching is to be enabled. | ||||||||
| CachingTimeLimit | Gets the Caching Time Limit for this Data Provider specified in Web.config. This is the maximum time in minutes to retain a cached document cached in RAM. | ||||||||
| Description | Overridden. Gets the description for this provider. | ||||||||
| MarkupIndexFileNameFormat | Gets the Markup Index File Name Format for this Data Provider specified in Web.config. The Markup Index File stores a list of all the Markup Layers associated with a particular Document ID. The only format substring which may be used indicates the Document Identifier for the corresponding document and must be specified, otherwise the default format will be used instead.
The following case-insensitive format substrings can be used when specifying the Art Data File Name Format.
| ||||||||
| MaxImageSizeToCache | Gets the Max Image Size To Cache specified in Web.config for this Data Provider. This is the maximum size in bytes of documents to cache in RAM. | ||||||||
| Name | Overridden. Gets the friendly name used to refer to the provider during configuration. | ||||||||
| SeparatorToken | Gets the Separator Token specified for this Data Provider in Web.config. This character will be used to delimit parts of the formatted file names used to store Markup Layers in a fashion such that they can be later parsed. | ||||||||
| StorageRootPath | Gets the Storage Root Path specified in Web.config for this Data Provider. This path is the path from which all documents will be served, and the path to which uploaded documents will be stored. | ||||||||
| UseDirectoryListing | Gets the Use Directory Listing value for this Data Provider specfied in Web.config. This value indicates whether a directory listing per the Art Data File Name Format is to be used to determine the association between documents and Markup Layers. Defaults to true. If this is set to false, the Developer will likely want to provide their own mechanism for retrieving a Markup Layer List for a given Document Identifier. This can be done either by a complete Data Provider implementation MarkupImageDataProvider, or by using MarkupArtMiddleware MarkupArtMiddleware. | ||||||||
| UseMarkupIndexFile | Gets the Use Markup Index File value for this Data Provider specified in Web.config. This is a boolean value indicating whether a Markup Index File is to be used. A Markup Index file is a JSON file containing the Markup Layer List for a particular Document ID. This list may be generated using a directory listing if UseDirectoryListing is specified UseDirectoryListing. | ||||||||
| UseMarkupIndexFileCache | Only applicable if UseMarkupIndexFile is true. A boolean value which indicates whether to Cache Markup Index Files in RAM. |
| Name | Description | |
|---|---|---|
 | FormatArtFileName | Returns the formatted Art Data File Name according to the specified Document ID, Markup Layer Record ID, and Markup Layer Name |
| FormatMarkupIndexFileName | Returns the formatted Markup Index File Name for a specified Document Identifier |
| OpenArtData | Overridden. Opens connection for obtaining annotations data from the File storage system. |
| OpenImageData | Overridden. Opens connection for obtaining image data from the File storage system. |
| ParseArtFileName | Parses the given file name according to this provider's ArtDataFileNameFormat and extracts the Document Identifier, Markup Layer Record ID, and Markup Layer Name where applicable. |
| ParseMarkupIndexFileName | Parses the given file name according to this provider's MarkupIndexFileNameFormat and extracts the Document Identifier. |
| ReplaceInvalidFileNameCharacters | Replaces invalid file name characters in the specified file name with the specified string |