DatabaseNotEnabledForNotificationException Class

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

The exception that is thrown when a SQL Server database is not enabled to support dependencies associated with the SqlCacheDependency class. This class cannot be inherited.

Namespace:   System.Web.Caching
Assembly:  System.Web (in System.Web.dll)

System.Object
  System.Exception
    System.SystemException
      System.Web.Caching.DatabaseNotEnabledForNotificationException

[SerializableAttribute]
public sealed class DatabaseNotEnabledForNotificationException : SystemException

NameDescription
System_CAPS_pubmethodDatabaseNotEnabledForNotificationException()

Initializes a new instance of the DatabaseNotEnabledForNotificationException class.

System_CAPS_pubmethodDatabaseNotEnabledForNotificationException(String)

Initializes a new instance of the DatabaseNotEnabledForNotificationException class.

System_CAPS_pubmethodDatabaseNotEnabledForNotificationException(String, Exception)

Initializes a new instance of the DatabaseNotEnabledForNotificationException class with a specified error message and a reference to the inner exception that is the cause of this exception.

NameDescription
System_CAPS_pubpropertyData

Gets a collection of key/value pairs that provide additional user-defined information about the exception.(Inherited from Exception.)

System_CAPS_pubpropertyHelpLink

Gets or sets a link to the help file associated with this exception.(Inherited from Exception.)

System_CAPS_pubpropertyHResult

Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.(Inherited from Exception.)

System_CAPS_pubpropertyInnerException

Gets the Exception instance that caused the current exception.(Inherited from Exception.)

System_CAPS_pubpropertyMessage

Gets a message that describes the current exception.(Inherited from Exception.)

System_CAPS_pubpropertySource

Gets or sets the name of the application or the object that causes the error.(Inherited from Exception.)

System_CAPS_pubpropertyStackTrace

Gets a string representation of the immediate frames on the call stack.(Inherited from Exception.)

System_CAPS_pubpropertyTargetSite

Gets the method that throws the current exception.(Inherited from Exception.)

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_pubmethodGetBaseException()

When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.(Inherited from Exception.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

When overridden in a derived class, sets the SerializationInfo with information about the exception.(Inherited from Exception.)

System_CAPS_pubmethodGetType()

Gets the runtime type of the current instance.(Inherited from Exception.)

System_CAPS_pubmethodToString()

Creates and returns a string representation of the current exception.(Inherited from Exception.)

The following code example is an exception handler for a simple administration page for setting up change notification in a SQL Server database.

For the full code required to run the example, see the Example section of the SqlCacheDependencyAdmin class overview topic.

catch (DatabaseNotEnabledForNotificationException ex)
{
  enabledTables.Visible = false;
  disableTable.Visible = false;
  enabledTablesMsg.Text = "Cache notifications are not enabled in this database.";

  tableName.Visible = false;
  enableTable.Visible = false;
  tableEnableMsg.Text = "Must enable database for notifications before enabling tables";
}

.NET Framework
Available since 2.0

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

Return to top
Show: