Language

Install Method

Adds the entries to the Machine.config file to allow an application using that configuration to use ServiceBus elements in its config file.

Namespace:  Microsoft.ServiceBus.Configuration
Assembly:  Microsoft.ServiceBus (in Microsoft.ServiceBus.dll)

Syntax

'Declaration
Public Overrides Sub Install ( _
    stateSaver As IDictionary _
)
'Usage
Dim instance As RelayConfigurationInstaller
Dim stateSaver As IDictionary

instance.Install(stateSaver)
public override void Install(
    IDictionary stateSaver
)
public:
virtual void Install(
    IDictionary^ stateSaver
) override
abstract Install : 
        stateSaver:IDictionary -> unit 
override Install : 
        stateSaver:IDictionary -> unit 
public override function Install(
    stateSaver : IDictionary
)

Parameters

  • stateSaver
    Type: System.Collections. . :: . .IDictionary
    Saves the information needed to perform a commit, rollback, or uninstall operation. This parameter cannot be nullNothingnullptrunita null reference (Nothing in Visual Basic).

Exceptions

Exception Condition
[ArgumentException]

stateSaver is null Nothing nullptr unit a null reference (Nothing in Visual Basic) .

[ConfigurationErrorsException]

A valid Machine.config file could not be loaded.

[Exception]

An exception occurred in the BeforeInstall event handler of one of the installers in the collection.

-or-

An exception occurred in the AfterInstall event handler of one of the installers in the collection.

Remarks

Install(IDictionary) is most commonly used by using Installutil.exe or another installer targeting Microsoft.ServiceBus.dll. This allows an easy way to add the ServiceBus App.config settings into a Machine.config file.

See Also

Reference

RelayConfigurationInstaller Class

Microsoft.ServiceBus.Configuration Namespace