DeliveryChannel Constructor (Instance, String)

Artikel
12/15/2008

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
)

Parameter

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.

Hinweise

Aktualisierter Text:05. Dezember 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.

Beispiel

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)