EasyUAFormsApplication Class Methods

For a list of all members of this type, see EasyUAFormsApplication members.

Public Methods

	Name	Description
	AddToSystemMenu	Overloaded. Adds items related to OPC UA application to the system menu of the given form. The method adds the "Administer OPC UA Application" command to the system menu of the form, allowing the user to view and manage the certificate trust, and the own application certificate.
	AssureOwnCertificate	Assures presence and validity of the own certificate the application is currently configured to use. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	BeginObtainNewCertificate	Begins an asynchronous operation that obtains a new application own certificate from the certificate manager, and stores it for subsequent usage. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	CancelObtainNewCertificate	Cancels an asynchronous operation started with the OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.BeginObtainNewCertificate method. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	Clone	Overridden.
	CreateObjRef	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from System.MarshalByRefObject)
	CreateOwnCertificate	Creates the own certificate the application is currently configured to use. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	Dispose	Overloaded. (Inherited from System.ComponentModel.Component)
	EndObtainNewCertificate	Handles the end of the asynchronous operation started by the OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.BeginObtainNewCertificate method. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	Equals	(Inherited from object)
	ExportApplicationConfiguration	Exports the OPC UA application configuration data into an XML stream. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	ExportOwnCertificateToFile	Exports the own certificate and optionally its private key to a given file. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	ExportRegisteredApplication	Exports the registration data of the OPC UA application into an XML stream. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	ExportSecuredApplication	Exports the security settings of the OPC UA application into an XML stream. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	FindGdsRegistrations	Finds all registrations for this application URI in the GDS. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	FindOwnCertificate	Finds the own certificate the application is currently configured to use. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	GetCertificateSubjectName	Gets the subject distinguished name the application is configured to use for its certificates. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	GetEffectiveApplicationManifest	Gets the effective OPC UA application manifest, i.e. the currently used application registration information together with data related to PKI administration, such as paths to the certificate stores used. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	GetEffectiveHostNames	Get the effective application host names. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	GetHashCode	Serves as the default hash function. (Inherited from object)
	GetLifetimeService	Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from System.MarshalByRefObject)
	GetObjectData	(Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	GetPrivateKeyPasswordStrength	Determines strength of the password that is configured for use with the given certificate. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	GetSchema	(Inherited from OpcLabs.BaseLib.Widgets.Widget)
	GetService	(Inherited from OpcLabs.BaseLib.Widgets.Widget)
	GetType	Gets the System.Type of the current instance. (Inherited from object)
	ImportOwnCertificateFromFile	Imports the own certificate and its private key from a given file. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	InitializeLifetimeService	Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from System.MarshalByRefObject)
	ListCertificateSubIds	Finds all application certificate sub-ids. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	ListCertificateTypeElements	Retrieves certificate type elements for the certificate types available for a given application store kind. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	ProtectOrUnprotectOwnCertificate	Protects or unprotects the private key of the given certificate. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	ReadXml	(Inherited from OpcLabs.BaseLib.Widgets.Widget)
	RefreshTrustLists	Retrieves the current trust lists for the application from the certificate manager, and refreshes own certificate stores accordingly. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	RegisterToGds	Creates an application registration in the GDS, assigning it a new application ID. Existing registrations with the same application URI are removed first. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	RemoveOwnCertificates	Removes the own certificates the application is currently configured to use. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	RemovePrivateKeyPassword	Removes the password used to access the private key for given certificate. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	SetPrivateKeyPassword	Sets the password used to access the private key for given certificate. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	ToString	(Inherited from OpcLabs.BaseLib.Widgets.Widget)
	UnregisterFromGds	Removes an application registration from the GDS, if it exists. All existing registrations for the application URI are removed. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	UpdateGdsRegistration	Updates an application registration in the GDS, keeping its application ID. A new registration is created if the application is not yet registered in the GDS. Preexisting registrations with the same application URI are removed. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	ValidateOwnCertificate	Validates the own certificate the application is currently configured to use. (Inherited from OpcLabs.EasyOpc.UA.Application.EasyUAApplicationCore)
	ValueEquals	Overloaded. Defines a generalized method that classes must implement to create type-specific method for determining value equality of instances. Determines whether `this` instance has the same value as a given other instance. (Inherited from OpcLabs.BaseLib.Widgets.Widget)
	WriteXml	(Inherited from OpcLabs.BaseLib.Widgets.Widget)

Top

Protected Methods

	Name	Description
	Finalize	(Inherited from System.ComponentModel.Component)
	MemberwiseClone	Overloaded. Creates a shallow copy of the current System.MarshalByRefObject object. (Inherited from System.MarshalByRefObject)
	OnContextTypesChanged	Infrastructure. (Inherited from OpcLabs.BaseLib.Widgets.Widget)
	ReadXmlElement	Infrastructure. (Inherited from OpcLabs.BaseLib.Widgets.Widget)
	WriteXmlElement	Infrastructure. (Inherited from OpcLabs.BaseLib.Widgets.Widget)

Top

Extension Methods

	Name	Description
	AssureOwnCertificate	Overloaded. Assures presence of the own certificate the application is currently configured to use. The AssureOwnCertificate methods check if the application has its own application certificate (according to application configuration), and create the certificate if it is missing. Returns `true` if a new certificate has been created. Returns `false` if an existing certificate was found and accepted as the current own certificate. If the own certificate does not exist in the certificate store prior to the operation, the method creates it. Otherwise, the method also checks whether the instance certificate is present in the trusted peers certificate store, and if it is absent, it copies it there. This is in contrast to the OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.CreateOwnCertificate method, which always creates a new certificate when successful.
	BeginObtainNewCertificate	Overloaded. Begins obtaining a new application certificate from the certificate manager. The BeginObtainNewCertificate methods begin an asynchronous operation that obtains a new application own certificate from the certificate manager, and stores it for subsequent usage.
	CreateOwnCertificate	Overloaded. Creates the own application certificate. The CreateOwnCertificate methods create the own certificate the application is currently configured to use.
	ExportApplicationConfigurationToFile	Exports the OPC UA application configuration data into an XML file.
	ExportApplicationManifest	Exports the OPC UA application manifest into a stream.
	ExportApplicationManifestToFile	Exports the OPC UA application manifest into an XML file.
	ExportOwnCertificateToFile	Overloaded. Exports the own certificate and optionally its private key to a given file.
	ExportRegisteredApplicationToFile	Exports the registration data of the OPC UA application into an XML file.
	ExportSecuredApplicationToFile	Exports the security settings of the OPC UA application into an XML file.
	FindOwnCertificate	Finds the own certificate the application is currently configured to use.
	GetApplicationElement	Gets the OPC UA registration information for this application.
	GetApplicationId	Gets an application ID assigned to the application by a specified GDS.
	GetCertificateSubjectName	Gets the subject distinguished name the application is configured to use for its certificates.
	GetCertificateSubjectNameDictionary	Gets a dictionary of certificate subject names corresponding to all application certificate sub-ids.
	GetPrivateKeyPasswordStrength	Determines strength of the password that is configured for use with the default certificate.
	HasOwnCertificate	Overloaded. Determines whether the application's own certificate is present. Returns `true` if the application's own certificate is present in the certificate store. Returns `false` otherwise.
	HasPrivateKeyPassword	Overloaded. Determines whether a non-empty password is in use for the default certificate.
	ImportOwnCertificateFromFile	Imports the own default certificate and its private key from a given file.
	ListCertificateTypeElements	Retrieves certificate type elements available for an application instance.
	ObtainNewCertificate	Overloaded. Obtains a new certificate from the certificate manager. The ObtainNewCertificate methods obtain a new application own certificate from the certificate manager, and store it for subsequent usage. Returns the certificate obtained from the certificate manager. The operation is synchronous. It can take considerable time to execute, because it involves multiple steps, and waiting for a finalization of the request by the GDS (see the OpcLabs.EasyOpc.UA.Gds.IEasyUACertificateManagement.FinishRequest method). For an alternative based on asynchronous programming model (APM, System.IAsyncResult) pattern, see the OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.BeginObtainNewCertificate method and related extension methods. For a task-based asynchronous programming pattern alternative, see the ObtainNewCertificateAsync(IEasyUAClientServerApplication,UAEndpointDescriptor) extension method and its overloads.
	ObtainNewCertificateAsync	Overloaded. Asynchronously obtains a new certificate from the certificate manager. The ObtainNewCertificateAsync asynchronously obtain a new application own certificate from the certificate manager, and store it for subsequent usage. Returns a task that represents the asynchronous operation. The value of the `TResult` contains the certificate obtained from the certificate manager. The operation is asynchronous, because it involves multiple steps, and waiting for a finalization of the request by the GDS (see the OpcLabs.EasyOpc.UA.Gds.IEasyUACertificateManagement.FinishRequest method). For a synchronous alternative, see the ObtainNewCertificate(IEasyUAClientServerApplication,UAEndpointDescriptor) extension method and its overloads. For an alternative based on asynchronous programming model (APM, System.IAsyncResult) pattern, see the OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.BeginObtainNewCertificate method and related extension methods.
	ProtectOrUnprotectOwnCertificate	Protects or unprotects the private key of the default certificate.
	ProtectOwnCertificate	Overloaded. Protects the private key of the default certificate.
	RefreshTrustLists	Retrieves the current trust lists for the application from the certificate manager, and refreshes own certificate stores accordingly.
	RemoveOwnCertificate	Overloaded. Removes the own application certificate. The RemoveOwnCertificate methods removes the own default certificate the application is currently configured to use.
	SetPrivateKeyPassword	Sets the password used to access the private key for the default certificate.
	SetState<TNode>	Sets the arbitrary object associated with the node.
	UIAdministerApplication	Shows the form which allows the interactive user to administer the OPC UA application modally.
	UnprotectOwnCertificate	Overloaded. Unprotects the private key of the default certificate.
	ValidateOwnCertificate	Overloaded. Validates the own application certificate. The ValidateOwnCertificate methods validates the own certificate the application is currently configured to use. The own certificate must exist in the certificate store prior to the operation, otherwise an error is reported.

Top

Reference

EasyUAFormsApplication Class
OpcLabs.EasyOpc.UA.Forms.Application Namespace