Share via


Instance Constructor (NotificationServices, String)

Initializes a new instance of the Instance class with a NotificationServices object and a name.

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

Syntax

'Declaration
Public Sub New ( _
    notificationServices As NotificationServices, _
    name As String _
)
public Instance (
    NotificationServices notificationServices,
    string name
)
public:
Instance (
    NotificationServices^ notificationServices, 
    String^ name
)
public Instance (
    NotificationServices notificationServices, 
    String name
)
public function Instance (
    notificationServices : NotificationServices, 
    name : String
)

Parameters

  • name
    A String, between 1 and 64 characters in length, that specifies the name of the Notification Services instance. You use this instance name when administering the instance of Notification Services.

    You cannot change the instance name. You must drop the instance and create it again to change the name. If you attempt to change the name NMO will throw an exception.

Remarks

Updated text:5 December 2005

Each Notification Services instance on a Database Engine instance must have a unique name, which is not case-sensitive. For example, MyInstance and myinstance are not considered unique names.

Because this name is used for database objects, follow the SQL Server rules for regular identifiers. Do not use SQL Server reserved keywords or special characters, such as backslash (/), forward slash (\), left bracket ([), right bracket (]), double quotes ("), and single quote ('). For more information about SQL Server identifiers, see Identifiers.

This constructor sets the following default property values.

Property

Value

EncryptArguments

false

SchemaName

"dbo"

Example

The following examples show how to use this constructor:

Instance myInstance = new Instance(
    notificationServices, instanceName);
Dim myInstance As Instance = _
    New Instance(notificationServices, instanceName)

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
DatabaseName

Other Resources

Configuring Instances of Notification Services
NotificationServicesInstance Element (ICF)