DeliveryChannel Constructor (Instance, String)
Initializes a new instance of the DeliveryChannel class with an Instance and a name.
Namespace: Microsoft.SqlServer.Management.Nmo
Assembly: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)
Syntax
'Declaration
Public Sub New ( _
instance As Instance, _
name As String _
)
public DeliveryChannel (
Instance instance,
string name
)
public:
DeliveryChannel (
Instance^ instance,
String^ name
)
public DeliveryChannel (
Instance instance,
String name
)
public function DeliveryChannel (
instance : Instance,
name : String
)
Parameters
- instance
The parent Instance of Notification Services for this DeliveryChannel object.
name
A String of up to 64 characters that specifies the name of the DeliveryChannel object.You cannot change the name. To rename a delivery channel, you must remove the delivery channel and then add a new delivery channel that has the new name.
Remarks
Updated text:5 December 2005
The delivery channel name must be unique within the instance of Notification Services. Names are not case-sensitive. For example, Notification Services does not distinguish between "EmailChannel" and "emailchannel."
Delivery channel names cannot contain the following characters: open bracket ([), close bracket (]), quotation mark ("), single quote ('), backslash (\), and forward slash (/).
You also must set the ProtocolName property.
Example
The following example shows how to use this constructor when defining a delivery channel for the standard file delivery protocol:
// Define a delivery channel that uses the built-in File protocol
DeliveryChannel fileChannel =
new DeliveryChannel(myInstance, "FileChannel");
fileChannel.ProtocolName = "File";
// Define and add arguments for the file delivery channel
DeliveryChannelArgument fileNameArg =
new DeliveryChannelArgument(fileChannel, "FileName");
fileNameArg.Value = sampleDirectory +
@"\Notifications\FileNotifications.txt";
fileChannel.DeliveryChannelArguments.Add(fileNameArg);
// Add the file delivery channel to the instance
myInstance.DeliveryChannels.Add(fileChannel);
' Define a delivery channel using the built-in File protocol
Dim fileChannel As DeliveryChannel = _
New DeliveryChannel(myInstance, "FileChannel")
fileChannel.ProtocolName = "File"
' Define and add arguments for the file delivery channel
Dim fileNameArg As DeliveryChannelArgument = _
New DeliveryChannelArgument(fileChannel, "FileName")
fileNameArg.Value = sampleDirectory + _
"\Notifications\FileNotifications.txt"
fileChannel.DeliveryChannelArguments.Add(fileNameArg)
' Add the file delivery channel to the instance
myInstance.DeliveryChannels.Add(fileChannel)
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
DeliveryChannel Class
DeliveryChannel Members
Microsoft.SqlServer.Management.Nmo Namespace