Class Run

This behaves similarly to Download, except that it also runs the program after ensuring it is in the cache.

Inheritance

Object

ServiceProvider

ScopedOperation

CliCommand

Selection

Download

Run

Inherited Members

Download.UncachedImplementations

Download.BackgroundSelfUpdateAndClean()

Download.DownloadUncachedImplementations()

Download.ShowOutput()

Download.MinimumNetworkUseForBackgroundSelfUpdate

Selection.SelectionsDocument

Selection.CustomizeSelections

Selection.ShowXml

Selection.Selections

Selection.Parse(IReadOnlyList<String>)

Selection.SetInterfaceUri(FeedUri)

Selection.RefreshSolve()

Selection.ShowSelections()

Selection.AdditionalArgsMin

Selection.Requirements

CliCommand.Options

CliCommand.AdditionalArgs

CliCommand.SupportedValues<T>(T[])

CliCommand.SupportedValues<T>()

CliCommand.FetchAll(IEnumerable<Implementation>)

CliCommand.AsParallel<T>(IEnumerable<T>)

CliCommand.Create(String, ICommandHandler)

CliCommand.CreateAndParse(IReadOnlyList<String>, ICommandHandler)

CliCommand.GetCommandName(IReadOnlyList<String>)

CliCommand.FullName

CliCommand.HelpText

CliCommand.Handler

CliCommand.ImplementationsInReadOnlyStores

ScopedOperation.GetCanonicalUri(String)

ScopedOperation.GetCatalog()

ScopedOperation.FindByShortName(String)

ScopedOperation.BackgroundSelfUpdate()

ScopedOperation.StartCommandBackground(String, String[])

ServiceProvider.TrySolveOffline(Requirements)

ServiceProvider.Config

ServiceProvider.ImplementationStore

ServiceProvider.OpenPgp

ServiceProvider.FeedCache

ServiceProvider.TrustManager

ServiceProvider.FeedManager

ServiceProvider.CatalogManager

ServiceProvider.PackageManager

ServiceProvider.SelectionCandidateProvider

ServiceProvider.Solver

ServiceProvider.Fetcher

ServiceProvider.Executor

ServiceProvider.SelectionsManager

Namespace: ZeroInstall.Commands.Basic

Assembly: 0install.dll

Syntax

public class Run : Download

Constructors

Run(ICommandHandler)

Creates a new run command.

Declaration

public Run(ICommandHandler handler)

Parameters

Type	Name	Description
ICommandHandler	handler	A callback object used when the the user needs to be asked questions or informed about download and IO tasks.

Fields

Name

Declaration

public const string Name = "run"

Field Value

Type	Description
String

Properties

AdditionalArgsMax

Declaration

protected override int AdditionalArgsMax { get; }

Property Value

Type	Description
Int32

Overrides

Selection.AdditionalArgsMax

Description

Declaration

public override string Description { get; }

Property Value

Type	Description
String

Overrides

Download.Description

Usage

Declaration

public override string Usage { get; }

Property Value

Type	Description
String

Overrides

Selection.Usage

Methods

Execute()

Executes the commands specified by the command-line arguments. Must call Parse(IReadOnlyList<String>) first!

Declaration

public override ExitCode Execute()

Returns

Type	Description
ExitCode	The exit status code to end the process with.

Overrides

Download.Execute()

Remarks

When inheriting this method is usually replaced.

Exceptions

Type	Condition
OperationCanceledException	The user canceled the task.
NDesk.Options.OptionException	The number of arguments passed in on the command-line is incorrect.
WebException	A file could not be downloaded from the internet.
NotSupportedException	A file format, protocol, etc. is unknown or not supported.
IOException	A downloaded file could not be written to the disk or extracted or an external application or file required by the solver could not be accessed.
UnauthorizedAccessException	An operation failed due to insufficient rights.
InvalidDataException	A problem occurred while deserializing an XML file.
SignatureException	The signature data could not be handled for some reason.
FormatException	An URI, local path, version number, etc. is invalid.
DigestMismatchException	An Implementation's Archives don't match the associated ManifestDigest.
SolverException	The ISolver was unable to provide Selections that fulfill the Requirements.
ImplementationNotFoundException	One of the ImplementationBases is not cached yet.
ExecutorException	The IExecutor was unable to process the Selections.

Solve()

Runs Solve(Requirements) (unless SelectionsDocument is true) and stores the result in Selections.

Declaration

protected override void Solve()

Overrides

Download.Solve()

Exceptions

Type	Condition
OperationCanceledException	The user canceled the task.
WebException	A file could not be downloaded from the internet.
IOException	An external application or file required by the solver could not be accessed.
SolverException	The ISolver was unable to provide Selections that fulfill the Requirements.