HostedEmailProviderException Class

Article
09/23/2016

Represents errors that occur in tasks performed by the hosted email provider.

Namespace: Microsoft.WindowsServerSolutions.HostedEmail
Assembly: Wssg.HostedEmailObjectModel (in Wssg.HostedEmailObjectModel.dll)

Inheritance Hierarchy

System.Object
System.Exception
Microsoft.WindowsServerSolutions.HostedEmail.HostedEmailProviderException

Syntax

[SerializableAttribute]
public class HostedEmailProviderException : Exception

[SerializableAttribute]
public ref class HostedEmailProviderException : Exception

<SerializableAttribute>
Public Class HostedEmailProviderException
    Inherits Exception

Constructors

	Name	Description
	HostedEmailProviderException()	Creates a new instance of the HostedEmailProviderException object.
	HostedEmailProviderException(SerializationInfo, StreamingContext)	Creates a new instance of the HostedEmailProviderException object, using the specified information and context.
	HostedEmailProviderException(String)	Creates a new instance of the HostedEmailProviderException object with a specified error message.
	HostedEmailProviderException(String, Exception)	Creates a new instance of the HostedEmailProviderException object, using the specified message and inner exception.
	HostedEmailProviderException(String, HostedEmailConfigureFault)	Creates a new instance of the HostedEmailProviderException object, using the specified error message and fault.
	HostedEmailProviderException(String, HostedEmailConfigureFault, Exception)	Creates a new instance of the HostedEmailProviderException object using the specified message, fault, and inner exception.

Properties

	Name	Description
	Data	(Inherited from Exception.)
	Fault	Retrieves or sets the fault that caused the exception.
	HelpLink	(Inherited from Exception.)
	HResult	(Inherited from Exception.)
	InnerException	(Inherited from Exception.)
	Message	(Inherited from Exception.)
	Source	(Inherited from Exception.)
	StackTrace	(Inherited from Exception.)
	TargetSite	(Inherited from Exception.)

Methods

	Name	Description
	Equals(Object)	(Inherited from Object.)
	Finalize()	(Inherited from Object.)
	GetBaseException()	(Inherited from Exception.)
	GetHashCode()	(Inherited from Object.)
	GetObjectData(SerializationInfo, StreamingContext)	Sets the serialization information about the exception.(Overrides Exception.GetObjectData(SerializationInfo, StreamingContext).)
	GetType()	(Inherited from Exception.)
	MemberwiseClone()	(Inherited from Object.)
	ToString()	Creates and returns a string representation of the current exception.(Overrides Exception.ToString().)

Events

	Name	Description
	SerializeObjectState	(Inherited from Exception.)

Remarks

For more information about implementing hosted email provider exceptions, see How to: Implement Adapter Error Handling.

Examples

The following code describes catching a HostedEmailProviderException as part of the process of loading a hosted email provider. For the complete sample code, see Quickstart: Creating a Hosted Email Adapter.

internal void StartLoadingData()
{
    ShowSplash();
    ThreadPool.QueueUserWorkItem((state) =>
        {
            // Load email account bound with wss user
            try
            {
                LoadEmailAccountInfo(this.propertyBag.UserName);
            }
            catch (InvalidOperationException)
            {
                ShowError();
            }
            catch (OperationInvokeException e)
            {
                HostedEmailProviderException hepe = e.InnerException as HostedEmailProviderException;
                if (hepe != null && hepe.Fault == HostedEmailConfigureFault.WssUserNotAssigned)
                {
                    ShowNoEmailAccountAssigned();
                }
                else
                {
                    ShowError();
                }
                return;
            }

            // Load distribution groups
            LoadDistributionGroups();

            OnDataLoaded();
        });
}

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.