/// <summary>
/// Creates an instance of the <see cref="AuthenticatedConnection"/>
/// class with the specified credential.
/// </summary>
///
/// <param name="credential">
/// The credential of the user to authenticate for access to HealthVault.
/// </param>
/// <remarks>
/// The base class, <see cref="ApplicationConnection"/>, obtains an
/// application identifier and a service URL from the configuration file.
/// </remarks>
/// <exception cref="ArgumentNullException">
/// The <paramref name="credential"/> parameter is <b>null</b>.
/// </exception>
///
/// <exception cref="InvalidConfigurationException">
/// The web or application configuration file does not contain
/// configuration entries for "ApplicationID" or "HealthServiceUrl".
/// </exception>
///
public AuthenticatedConnection(
Credential credential)
: base()
{
Validator.ThrowIfArgumentNull(credential, "credential", "CtorUsernameNullOrEmpty");
Credential = credential;
}
/// <summary>
/// Creates a new instance of the <see cref="WebApplicationConnection"/> class
/// with the specified app-ID, and credential.
/// </summary>
///
/// <param name="callingApplicationId">
/// The HealthVault application identifier.
/// </param>
///
/// <param name="credential">
/// The credential of the user to authenticate for access to
/// HealthVault.
/// </param>
///
/// <exception cref="ArgumentNullException">
/// The <paramref name="credential"/> is <b>null</b>.
/// </exception>
///
public WebApplicationConnection(
Guid callingApplicationId,
Credential credential)
: base(callingApplicationId,
credential)
{
}
/// <summary>
/// Creates a new instance of the <see cref="WebApplicationConnection"/> class with
/// default values from the application or web configuration file.
/// </summary>
///
/// <param name="credential">
/// The credential of the user to authenticate for access to
/// HealthVault.
/// </param>
///
/// <exception cref="ArgumentNullException">
/// The <paramref name="credential"/> parameter is <b>null</b>.
/// </exception>
///
public WebApplicationConnection(Credential credential)
: base(credential)
{
}
/// <summary>
/// Creates a new instance of the <see cref="WebApplicationConnection"/> class
/// with the specified app-ID, string-formatted URL, and credential.
/// </summary>
///
/// <param name="callingApplicationId">
/// The HealthVault application identifier.
/// </param>
///
/// <param name="healthServiceUrl">
/// The URL of the HealthVault service.
/// </param>
///
/// <param name="credential">
/// The credential of the user to authenticate for access to
/// HealthVault.
/// </param>
///
/// <exception cref="ArgumentNullException">
/// The <paramref name="healthServiceUrl"/> parameter or
/// <paramref name="credential"/> is <b>null</b>.
/// </exception>
///
public WebApplicationConnection(
Guid callingApplicationId,
string healthServiceUrl,
Credential credential)
: this(callingApplicationId,
new Uri(healthServiceUrl),
credential)
{
}
/// <summary>
/// Creates a new instance of the <see cref="WebApplicationConnection"/> class
/// with the specified app-ID, URL, and credential.
/// </summary>
///
/// <param name="callingApplicationId">
/// The HealthVault application identifier.
/// </param>
///
/// <param name="healthServiceUrl">
/// The URL of the HealthVault service.
/// </param>
///
/// <param name="credential">
/// The credential of the user to authenticate for access to
/// HealthVault.
/// </param>
///
/// <exception cref="ArgumentNullException">
/// The <paramref name="healthServiceUrl"/> parameter or
/// <paramref name="credential"/> is <b>null</b>.
/// </exception>
///
public WebApplicationConnection(
Guid callingApplicationId,
Uri healthServiceUrl,
Credential credential)
: base(callingApplicationId,
healthServiceUrl,
credential)
{
}
/// <summary>
/// Creates an instance of the <see cref="AuthenticatedConnection"/>
/// class with the specified application identifier, URL, and
/// credential.
/// </summary>
///
/// <param name="callingApplicationId">
/// The HealthVault application identifier.
/// </param>
///
/// <param name="healthServiceUrl">
/// The URL of the HealthVault web service.
/// </param>
///
/// <param name="credential">
/// The credential of the user to authenticate for access to HealthVault.
/// </param>
///
/// <exception cref="ArgumentNullException">
/// The <paramref name="healthServiceUrl"/> or
/// <paramref name="credential"/> parameter is <b>null</b>.
/// </exception>
///
public AuthenticatedConnection(
Guid callingApplicationId,
Uri healthServiceUrl,
Credential credential)
: base(callingApplicationId,
healthServiceUrl)
{
Validator.ThrowIfArgumentNull(credential, "credential", "CtorUsernameNullOrEmpty");
Credential = credential;
}