File

File Operations

CopyTo copies the file to a destination path. MoveTo moves the file to a new location - the original is removed. Delete() removes the current file. Delete(string) removes the file at a specified path. ToGPALObject() returns the GPALFile instance typed as IGPALFile for interface-based use.

These operations work on the file specified by WithFileName (or GPAL.FileFor).

The path itself is readable in pieces: DirectoryPart is the folder and FilePart is the name with its extension, both for the file the GPALFile is currently on, which is what CopyTo and MoveTo need when a destination is built from where the file came from.

SaveTo saves the files as an archive, a zip, gz, tar or tar.gz picked by the destination's extension. See Archives: Opening and Saving.

NOTE

A GPALFile holds however many files its name matched, so the path pieces come in a singular and a plural. DirectoryPart and FilePart answer for the one file the object is on. DirectoryParts and FileParts answer for every file it holds, in the same order as Filenames, so a wildcard that matched thirty files gives thirty of each. A name that matched nothing answers with empty rather than failing, because asking a GPALFile for its folder is not the same as asking it to find something.

Examples

GPAL Fluent: High-level fluent C# API

//CopyTo and MoveTo accept a full destination path including the filename. If the destination directory does not exist, the operation will fail - ensure the target directory exists before calling. Building a destination out of the pieces rather than out of the whole path is what keeps a copy working when the source moves: DirectoryPart changes and FilePart does not.

// Copy a downloaded file to a target directory

GPAL.File

.WithFileName("C:\Downloads\report.pdf")

.ToGPALObject()

.CopyTo("C:\Archive\reports\2026-report.pdf");

// Move a processed file

GPAL.File

.WithFileName("C:\Inbox\data.csv")

.ToGPALObject()

.MoveTo("C:\Processed\data.csv");

// Delete a temporary file

GPAL.File

.WithFileName("C:\temp\working.tmp")

.ToGPALObject()

.Delete();

Documentation Example

Documentation

Showing off some plain text in these paragraphs eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Other formats

Here you can find different accents and emphasis sit amet consectetur adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

This is a link and how it could look like bestlinkinthebeautifulworld. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Here's just some classic bold text adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam notBoldSecondbestlinkinthebeautifulworld illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Obcaecati, iste distinctio veritatis eligendi laboriosam adipisicing elit illo nostrum corporis at adipisicing elit libero vel voluptas? Expedita, adipisicing facere dolores voluptatem ad ab rem assumenda soluta!

Other cuple of colors in case we want to emphasize several ways adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam adipisicing elit illo nostrum corporis at voluptatem libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Adding Images to the content

Lorem ipsum dolor sit amet consectetur adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta! Lorem ipsum dolor, sit amet consectetur adipisicing elit. Quod veniam, quam ad expedita laborum sed at voluptates culpa ipsam ut vel. Ullam temporibus a mollitia quod aliquam ratione exercitationem nesciunt.

Coding Blocks

Lorem ipsum dolor sit amet consectetur adipisicing elit. Repudiandae quas consequuntur illo numquam assumenda autem exercitationem distinctio perspiciatis in natus. Eius dicta similique ipsam ipsa minima, nemo quae enim tempore.

GPAL

.CallIfNotFound(GenericCallIfNotFound)

.WithPublishToConsole();

//System.Drawing.Rectangle windowSize = new System.Drawing.Rectangle(10, 10, 1500, 1024);

// NOTE: we have to set browser = before we execute any steps

// this is due to the 'GenericCallIfNotFound' which might throw an exception, and BankScraper will not have the browser set when it calls scraper.Close()

// until the complete fluent line gets executed (meaning every step, meaning browser is not set until everything else succeeds)

browser = GPAL.Browser

.WithBrowserType(Enums.BrowserType.Chrome)

.WithProfileDataDirectory(ChromeProfileLocation)

.WithUseAutomationEngine(AutomationEngine.Selenium)

.WithWindowSize(new System.Drawing.Rectangle(0,0,1920,1080))

.ToGPALObject();

File

File

File Operations

Examples

Documentation Example

Documentation

Category

Endpoint

Enpoint

Enpoint

Enpoint

Other formats

Adding Images to the content

Coding Blocks

On this page