ResourceStorage

This is the primary constructor that provides complete control over storage configuration and folder management behavior.

This constructor is obsolete and provided for backward compatibility; use ResourceStorage(string) instead.

Creates storage with custom folder exclusions while using the standard default folder structure (Data, Images, Styles).

Creates storage with no excluded folders and uses the standard default folder structure (Data, Images, Styles).

This constant defines the default folder name "Resources" used across the application for storing report assets.

This override implementation delegates to CreateFolder with throwIfExists set to false, allowing silent handling of existing folders during initialization. This behavior is essential for the default folder creation process where folders may already exist from previous runs.

Validates that the resulting path remains within the base directory to prevent directory traversal attacks. Creates the complete directory hierarchy if any intermediate directories don't exist.

Always throws an exception if the folder already exists, providing strict creation semantics for public API usage.

Performs a recursive deletion that removes the folder and all contained files and subdirectories. The root folder cannot be deleted to maintain storage integrity.

First creates the root base directory if it doesn't exist, then delegates to the base class to create the standard default folders (Data, Images, Styles). This override ensures the storage directory structure is properly initialized before creating nested default folders.

Validates the URI parameter and transforms it to an absolute file system path before checking directory existence. This method provides the core folder existence checking functionality used throughout the resource storage system.

Uses efficient enumeration to check for existence of any content without loading all items into memory.

The default implementation delegates to FolderExists(string), treating the folderName as equivalent to a URI. This method provides an alternative interface for folder existence checking using name-based paths.

Performs a recursive search starting from the base directory and includes all nested subdirectories in the search operation.

The default implementation delegates to GetByUri(string) and treats the resourceName as a URI equivalent. This method provides asynchronous access to resource file contents for improved performance in web applications.

Validates the URI parameter and transforms it to an absolute file system path before reading the file contents. This method provides synchronous access to resource file data for immediate use.

Validates the URI parameter, reads the complete file contents, and constructs a download-ready model with file metadata. MIME type detection is currently not implemented and will be added in future versions based on file extension analysis.

Handles both root directory requests and nested folder requests with appropriate parent path resolution.

The default implementation delegates to GetFolder(string) method, treating folderName as a URI equivalent.

Combines first-level subfolders with files matching the search patterns, providing comprehensive folder content enumeration.

Uses a wildcard search pattern to include all file types and delegates to the overloaded GetFolderContents method.

This ordering strategy guarantees that any non-existing parent folders are created before their children during initialization.

Delegates to MoveCore for the actual file system operation while preserving the resource's filename and contents. The resource is relocated to the specified parent directory without changing its name or file contents.

Performs a complete directory move operation including all files and subdirectories within the source folder.

Validates the rename operation parameters and delegates to RenameCore for the actual file system operation. The resource remains in the same directory location but with the updated filename.

This operation is implemented as a directory move within the same parent directory, preserving all files and subdirectories. The folder remains in the same parent location but with the updated name.

Validates the URI parameter and transforms it to an absolute file system path before checking file existence. Returns false if any exception occurs during path resolution or file system access, providing safe existence checking.

The default implementation delegates to ResourceExists(string), treating the resourceName as equivalent to a URI. This method provides an alternative interface for resource existence checking using name-based paths instead of URI format.