UA Bundle SDK .NET
2.2.4.281
|
Represents an instance of a UA application. More...
Classes | |
class | BuiltInCommands |
The built-in command line parameters. More... | |
class | CommandDescription |
Stores the description of a command. More... | |
class | WindowsService |
Manages the interface between the UA server and the Windows SCM. More... | |
Public Member Functions | |
MessageContext | GetServerMessageContext () |
Create a new message context for the server. More... | |
StatusCode | GetEndpointStatus (EndpointDescription endpoint) |
Gets the endpoint status. More... | |
void | SetEndpointStatus (EndpointDescription endpoint, StatusCode status) |
Sets the endpoint status. More... | |
virtual void | SetApplicationSettings (UaSchema.SecuredApplication settings) |
Sets the application settings. More... | |
T | GetConfigurationExtension< T > (bool silent) |
Parses the extension. More... | |
T | GetConfigurationExtension< T > (bool silent, XmlQualifiedName elementName) |
Parses the extension. More... | |
void | SetConfigurationExtension< T > (T extension) |
Updates the extension. More... | |
virtual void | ValidateCertificate (ICertificate certificate) |
Verifies the certificate. More... | |
virtual void | AddCertificateToTrustList (ICertificate certificate) |
Adds the certificate to trust list. More... | |
void | Install () |
Installs the application. More... | |
void | Uninstall () |
Uninstalls the application. More... | |
void | Install (bool silent) |
Installs the application. More... | |
void | Uninstall (bool silent) |
Uninstalls the application. More... | |
void | Start () |
Starts the application. More... | |
void | Start (WaitCallback callback, object userData) |
Starts the application. More... | |
void | Start (ServerBase server, WaitCallback callback, object userData) |
Starts the application. More... | |
void | LoadConfiguration (bool silent, bool isServer) |
Loads the configuration. More... | |
void | SaveConfiguration (bool silent) |
Saves the configuration. More... | |
virtual void | SaveConfiguration (Stream ostrm, bool silent) |
Saves the configuration. More... | |
Protected Member Functions | |
virtual void | ExchangeLdsCertificates () |
Adds a copy of the application certificate to the trusted store of the local discovery server and adds a copy of the lds certificate to the trusted store of the application. More... | |
virtual void | PreInstallProcessing (bool silent, UaSchema.InstallationSettings settings) |
Does any pre-install processing. More... | |
virtual void | PostInstallProcessing (bool silent, UaSchema.InstallationSettings settings) |
Does any post-install processing. More... | |
ICertificateStore | FindTrustedStoreForLDS () |
Finds the trusted store for LDS. More... | |
ICertificate | FindCertificateForLDS () |
Finds the certificate for LDS. More... | |
virtual void | InstallService (bool silent, UaSchema.InstallationSettings settings) |
Installs the service. More... | |
virtual List< AccessRule > | GetAccessRules (UaSchema.InstallationSettings settings) |
Gets the access rules. More... | |
virtual void | SetFilePermissions (bool silent, UaSchema.InstallationSettings settings) |
Sets the file permissions. More... | |
virtual void | OpenFirewallPorts (UaSchema.InstallationSettings settings) |
Opens the firewall ports. Called during the /install command. More... | |
virtual void | CloseFirewallPorts (UaSchema.InstallationSettings settings) |
Closes the firewall ports. Called during the /uninstall command. More... | |
virtual void | CreateHttpsBindings (UaSchema.InstallationSettings settings) |
Creates the HTTPS bindings. Called during the /install command. More... | |
virtual void | DeleteHttpsBindings (UaSchema.InstallationSettings settings) |
Deletes the HTTPS bindings. Called during the /uninstall command. More... | |
virtual void | RemoveCertificateFromLds () |
Removes the application certificate from the trusted store of the local discovery server. More... | |
virtual void | PreUninstallProcessing (bool silent, UaSchema.InstallationSettings settings) |
Does any pre-uninstall processing. More... | |
virtual void | PostUninstallProcessing (bool silent, UaSchema.InstallationSettings settings) |
Does any post-uninstall processing. More... | |
virtual void | UninstallService (bool silent, UaSchema.InstallationSettings settings) |
Uninstalls the service. More... | |
virtual string | ValidateArguments (bool ignoreUnknownArguments, Dictionary< string, string > args) |
Validates the arguments. More... | |
virtual CommandDescription[] | GetCommandDescriptions () |
Gets the descriptions for the supported command line arguments. More... | |
virtual string | GetHelpString (CommandDescription[] commands) |
Gets the help string for the command line parameters. More... | |
virtual bool | ProcessCommand (bool silent, Dictionary< string, string > args) |
Processes the command. More... | |
virtual bool | CheckConfiguration (bool silent) |
Checks the configuration. More... | |
EndpointDescription | GetEndpointDescription (string endpointUri, string securityProfileUri, MessageSecurityMode securityMode, bool supportXmlEncoding, ApplicationDescription application) |
Gets the endpoint description. More... | |
void | ApplyTraceSettings () |
Applies the trace settings found in the ApplicationSettings. More... | |
virtual void | LoadConfigurationAsDefault (bool isServer) |
Creates the default application settings. More... | |
void | LoadConfiguration (Stream istrm, bool silent) |
Loads the configuration. More... | |
Properties | |
static ApplicationInstance | Default [get] |
Gets the default ApplicationInstance for the process. More... | |
string | ApplicationName [get, set] |
Gets or sets the name of the application. More... | |
string | ApplicationUri [get, set] |
Gets or sets the application URI. More... | |
ApplicationType | ApplicationType [get, set] |
Gets or sets the type of the application. More... | |
string | ProductUri [get, set] |
Gets or sets the product URI. More... | |
string | ProductVersion [get, set] |
Gets or sets the product version. More... | |
ICertificate | ApplicationCertificate [get, set] |
Gets or sets the application certificate. More... | |
ICertificateStore | TrustedStore [get, set] |
Gets or sets the trusted store. More... | |
ICertificateStore | IssuerStore [get, set] |
Gets or sets the issuer store. More... | |
ICertificateStore | RejectedStore [get, set] |
Gets or sets the rejected store. More... | |
EncodeableFactory | KnownTypeFactory [get, set] |
Gets or sets the known type factory. More... | |
EndpointConfiguration | DefaultEndpointConfiguration [get, set] |
Gets or sets the default endpoint configuration. More... | |
CertificateValidator | CertificateValidator [get, set] |
Gets or sets the certificate validator. More... | |
IList< EndpointDescription > | Endpoints [get, set] |
Gets or sets the endpoints. More... | |
bool | IsStarted [get, set] |
Gets a value indicating whether this instance is started. More... | |
bool | AutoCreateCertificate [get, set] |
Gets or sets a value indicating whether the certificate should be automatically created. More... | |
bool | NoAutoStartService [get, set] |
Gets or sets a value indicating whether a Windows service should be automatically started if the EXE was started by a non-interactive user. More... | |
bool | DisableCommandLineProcessing [get, set] |
Gets or sets a value indicating whether that the SDK should NOT attempt to interpret the command line when it is initialize. More... | |
string | ConfigurationFilePath [get, set] |
Gets or sets the configuration file path. More... | |
string | EmbeddedConfigurationAssemblyName [get, set] |
Gets or sets the name of the assembly which has the embedded resource containing the default configuration file. More... | |
UaSchema.SecuredApplication | ApplicationSettings [get, set] |
Gets the application settings. More... | |
static UntrustedCertificateEventHandler | UntrustedHttpsCertificate |
Occurs when an untrusted certificate is encountered. More... | |
Dictionary< string, string > | CommandLine [get, set] |
Gets the command line parameters passed to the process. More... | |
Events | |
CreateCertificateEventHandler | MissingApplicationCertificate |
Occurs when the application certificate is missing. More... | |
CreateHttpsCertificateEventHandler | MissingHttpsCertificate |
Occurs when the HTTPS certificate is missing. More... | |
UntrustedCertificateEventHandler | UntrustedCertificate |
Occurs when an untrusted certificate is encountered. More... | |
EventHandler | ConfigurationChanged |
Occurs if the configuration has changed and needs to be persisted. More... | |
Represents an instance of a UA application.
|
inlinevirtual |
Adds the certificate to trust list.
certificate | The certificate. |
|
inlineprotected |
Applies the trace settings found in the ApplicationSettings.
|
inlineprotectedvirtual |
Checks the configuration.
silent | if set to true then no exceptions will be thrown. |
|
inlineprotectedvirtual |
Closes the firewall ports. Called during the /uninstall command.
All ports used by the application are closed even if they were already open at install time. Developers can override the method if they need something different.
|
inlineprotectedvirtual |
Creates the HTTPS bindings. Called during the /install command.
All HTTPS addresses are bound to all IP address using the HTTPS certificate in the InstallationSettings. Developers can override the method if they need something different.
|
inlineprotectedvirtual |
Deletes the HTTPS bindings. Called during the /uninstall command.
All HTTPS addresses are unbound from all IP addresses. Developers can override the method if they need something different.
|
inlineprotectedvirtual |
Adds a copy of the application certificate to the trusted store of the local discovery server and adds a copy of the lds certificate to the trusted store of the application.
|
inlineprotected |
Finds the certificate for LDS.
|
inlineprotected |
Finds the trusted store for LDS.
|
inlineprotectedvirtual |
Gets the access rules.
settings | The settings. |
|
inlineprotectedvirtual |
Gets the descriptions for the supported command line arguments.
|
inline |
Parses the extension.
T |
silent | if set to true then errors are suppressed. |
T | : | class |
|
inline |
Parses the extension.
T |
silent | if set to true then errors are suppressed. |
elementName | Name of the element. |
If the elementName is not null the type passed must support DataContract serialization or have the XmlRoot attribute defined.
T | : | class |
|
inlineprotected |
Gets the endpoint description.
endpointUri | The endpoint URI. |
securityProfileUri | The security profile URI. |
securityMode | The security mode. |
supportXmlEncoding | if set to true the endpoint supports the XML encoding. |
application | The application. |
|
inline |
Gets the endpoint status.
endpoint | The endpoint. |
|
inlineprotectedvirtual |
Gets the help string for the command line parameters.
commands | The descriptions for the supported arguments. |
|
inline |
Create a new message context for the server.
|
inline |
Installs the application.
|
inline |
Installs the application.
|
inlineprotectedvirtual |
Installs the service.
silent | Do not throw exceptions if TRUE. |
settings | The settings. |
|
inline |
Loads the configuration.
silent | if set to true then no exceptions will be thrown. |
isServer | if set to true the application is a server. |
|
inlineprotected |
Loads the configuration.
istrm | The stream to read. |
silent | If set to true then no exceptions will be thrown. |
|
inlineprotectedvirtual |
Creates the default application settings.
isServer | if set to true the application is a server. |
|
inlineprotectedvirtual |
Opens the firewall ports. Called during the /install command.
By default ports are openedin the 'Public' profile for each port used by the base address. Developers can override the method if they need something different.
|
inlineprotectedvirtual |
Does any post-install processing.
silent | Do not throw exceptions if TRUE. |
settings | The settings. |
|
inlineprotectedvirtual |
Does any post-uninstall processing.
silent | Do not throw exceptions if TRUE. |
settings | The settings. |
|
inlineprotectedvirtual |
Does any pre-install processing.
silent | Do not throw exceptions if TRUE. |
settings | The settings. |
|
inlineprotectedvirtual |
Does any pre-uninstall processing.
silent | Do not throw exceptions if TRUE. |
settings | The settings. |
|
inlineprotectedvirtual |
Processes the command.
silent | if set to true no dialogs such be displayed. |
args | Additional arguments provided on the command line. |
|
inlineprotectedvirtual |
Removes the application certificate from the trusted store of the local discovery server.
|
inline |
Saves the configuration.
silent | If set to true then no exceptions will be thrown. |
|
inlinevirtual |
Saves the configuration.
ostrm | The stream to write to. |
silent | if set to true then no exceptions will be thrown. |
|
inlinevirtual |
Sets the application settings.
settings | The settings. |
This method cannot be called after Start() has been called.
|
inline |
Updates the extension.
T |
extension | The extension. |
T | : | class |
|
inline |
Sets the endpoint status.
endpoint | The endpoint. |
status | The status. |
|
inlineprotectedvirtual |
Sets the file permissions.
silent | Do not throw exceptions if TRUE. |
settings | The settings. |
|
inline |
Starts the application.
|
inline |
Starts the application.
callback | The method to call when initialization is complete. |
userData | The user data to be passed to the callback. |
|
inline |
Starts the application.
server | The server. |
callback | The method to call when initialization is complete. |
userData | The user data to be passed to the callback. |
|
inline |
Uninstalls the application.
|
inline |
Uninstalls the application.
|
inlineprotectedvirtual |
Uninstalls the service.
silent | Do not throw exceptions if TRUE. |
settings | The settings. |
|
inlineprotectedvirtual |
Validates the arguments.
ignoreUnknownArguments | if set to true unknown arguments are ignored. |
args | The arguments passed on the command line. |
|
inlinevirtual |
Verifies the certificate.
certificate | The certificate. |
This method uses the application configuration to determine the trust list. An exception is thrown if any error occurs.
|
getset |
Gets or sets the application certificate.
The application certificate.
|
getset |
Gets or sets the name of the application.
The name of the application.
|
getset |
Gets the application settings.
Changing this object after Start() is called may have unpredicatable effects.
|
getset |
Gets or sets the type of the application.
The type of the application.
|
getset |
Gets or sets the application URI.
The application URI.
|
getset |
Gets or sets a value indicating whether the certificate should be automatically created.
true
if the certificate should be automatically created; otherwise, false
.
|
getset |
Gets or sets the certificate validator.
The certificate validator.
|
getsetprotected |
Gets the command line parameters passed to the process.
|
getset |
Gets or sets the configuration file path.
The configuration file path.
|
staticget |
Gets the default ApplicationInstance for the process.
|
getset |
Gets or sets the default endpoint configuration.
The default endpoint configuration.
|
getset |
Gets or sets a value indicating whether that the SDK should NOT attempt to interpret the command line when it is initialize.
true
if the SDK should NOT attempt to interpret command line options; otherwise, false
.
|
getset |
Gets or sets the name of the assembly which has the embedded resource containing the default configuration file.
The name of the assembly which has the embedded resource containing the default configuration file.
If not specified the EXE assembly is used.
|
getset |
Gets or sets the endpoints.
The endpoints.
|
getset |
Gets a value indicating whether this instance is started.
true
if this instance is started; otherwise, false
.
|
getset |
Gets or sets the issuer store.
The issuer store.
|
getset |
Gets or sets the known type factory.
The known type factory.
|
getset |
Gets or sets a value indicating whether a Windows service should be automatically started if the EXE was started by a non-interactive user.
true
if a Windows service should NOT be automatically started if the EXE was started by a non-interactive user; otherwise, false
.
|
getset |
Gets or sets the product URI.
The product URI.
|
getset |
Gets or sets the product version.
The product version.
|
getset |
Gets or sets the rejected store.
The rejected store.
|
getset |
Gets or sets the trusted store.
The trusted store.
|
staticaddremove |
Occurs when an untrusted certificate is encountered.
EventHandler UnifiedAutomation.UaBase.ApplicationInstance.ConfigurationChanged |
Occurs if the configuration has changed and needs to be persisted.
CreateCertificateEventHandler UnifiedAutomation.UaBase.ApplicationInstance.MissingApplicationCertificate |
Occurs when the application certificate is missing.
CreateHttpsCertificateEventHandler UnifiedAutomation.UaBase.ApplicationInstance.MissingHttpsCertificate |
Occurs when the HTTPS certificate is missing.
UntrustedCertificateEventHandler UnifiedAutomation.UaBase.ApplicationInstance.UntrustedCertificate |
Occurs when an untrusted certificate is encountered.