Share via

Instance.Drop Method ()

  • Article

Deletes the instance of Notification Services.

Namespace: Microsoft.SqlServer.Management.Nmo
Assembly: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)

Syntax

'Declaration
Public Sub Drop

public void Drop ()

public:
void Drop ()

public void Drop ()

public function Drop ()

Remarks

The instance of Notification Services must be registered locally to use this method. The account used to drop the instance must have permission to drop databases. This includes membership in the dbcreator or sysadmin fixed server role.

When you delete an instance of Notification Services, you delete the database objects for the instance and its applications. If Notification Services created the databases, the databases are deleted. Otherwise, only the objects created by Notification Services in the instance and application schemas are deleted.

After you delete an instance, you should also unregister the instance, unless you are going to recreate the instance and want to use the same registry information.

Deleting the instance when some databases have open connections can leave the instance in an inconsistent state.

Make sure to stop the Notification Services engine components before deleting the instance.

Example

The following examples show how to disable, unregister, and drop an instance of Notification Services:

// First disable the instance.
Console.WriteLine("Disabling instance...");
inst.Disable();

// Then unregister the instance.
Console.WriteLine("Unregistering instance...");
inst.UnregisterLocal();

// And then delete the instance.
Console.WriteLine("Deleting instance...");
inst.Drop();

Console.WriteLine("Done.");

' First disable the instance.
Console.WriteLine("Disabling instance...")
inst.Disable()

' Then unregister the instance.
Console.WriteLine("Unregistering instance...")
inst.UnregisterLocal()

' And then delete the instance.
Console.WriteLine("Deleting instance...")
inst.Drop()

Console.WriteLine("Done.")

Thread Safety

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

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

See Also

Reference

Instance Class
Instance Members
Microsoft.SqlServer.Management.Nmo Namespace
UnregisterLocal

Other Resources

Starting and Stopping Instances of Notification Services
Deleting Instances of Notification Services