Web​Application​Connection Class

Definition

Represents an authenticated interface to HealthVault.

public class WebApplicationConnection : Microsoft.Health.AuthenticatedConnection
Inheritance

Inherited Members

Microsoft.Health.ApplicationConnection

Microsoft.Health.AuthenticatedConnection

Microsoft.Health.HealthServiceConnection

Remarks

Most operations performed against the service require authentication. A connection must be made to HealthVault to access the web methods that the service exposes. The class does not maintain an open connection to the service. It uses XML over HTTP to make requests and receive responses from the service. The connection just maintains the data necessary to make the request.

An authenticated connection takes the user name and password, and authenticates against HealthVault and then stores an authentication token which is then passed to the service on each subsequent request. An authenticated connection is required for accessing a person's health record.

For operations that do not require authentication, the AnonymousConnection or ApplicationConnection class can be used.

Constructors

Web​Application​Connection(​Credential)

Creates a new instance of the WebApplicationConnection class with default values from the application or web configuration file.

Web​Application​Connection(​Health​Service​Instance, ​Credential)

Creates a new instance of the WebApplicationConnection class with the HealthVault web-service instance and credential.

Web​Application​Connection(​Guid, ​Credential)

Creates a new instance of the WebApplicationConnection class with the specified app-ID, and credential.

Web​Application​Connection(​Guid, ​Health​Service​Instance, ​Credential)

Creates a new instance of the WebApplicationConnection class with the specified app-ID, HealthVault web-service instance, and credential.

Web​Application​Connection(​Guid, ​String, ​Credential)

Creates a new instance of the WebApplicationConnection class with the specified app-ID, string-formatted URL, and credential.

Web​Application​Connection(​Guid, ​Uri, ​Credential)

Creates a new instance of the WebApplicationConnection class with the specified app-ID, URL, and credential.

Methods

Send​Insecure​Message(​IList<​Mail​Recipient>, ​String, ​String, ​String)

Sends an insecure message to the specified message recipients.

Send​Insecure​Message(​IList<​Guid>, ​Boolean, ​String, ​String, ​String)

Sends an insecure message to the specified message recipients.

Send​Insecure​Message​To​Custodians(​Guid, ​Boolean, ​String, ​String, ​String)

Sends an insecure message to custodians of the specified health record.