次の方法で共有


Instance.Update Method

Instance プロパティと Application プロパティに加えられた変更内容で、通知のインスタンスとそのすべてのアプリケーションを更新します。

名前空間: Microsoft.SqlServer.Management.Nmo
アセンブリ: Microsoft.SqlServer.Smo (microsoft.sqlserver.smo.dll 内)

構文

'宣言
Public Sub Update
public void Update ()
public:
void Update ()
public void Update ()
public function Update ()

解説

Update メソッドは、データベース内の現在のインスタンスおよびアプリケーション定義と、ユーザーのインスタンスおよびアプリケーションの定義を比較します。有効な変更ごとに、Update メソッドは、指定どおりにデータベースを更新します。

インスタンス プロパティとアプリケーション プロパティをすべて更新できるわけではありません。たとえば、インスタンスおよびアプリケーションのデータベース定義は変更できません。詳細については、更新対象のプロパティのドキュメントを参照してください。

一部の EventClass プロパティ、SubscriptionClass プロパティ、および NotificationClass プロパティを変更すると、アプリケーション データベースの既存のテーブルが削除されたり、名前が変更されたりすることがあります。プロパティを変更した場合の影響を確認してから、プロパティを変更することをお勧めします。

使用例

次の例は、Notification Services のインスタンスを更新する方法を示しています。

// Specify the Database Engine instance that hosts the 
// Notificaiton Services instance and get a reference to 
// the NotificationServices object.
smo.Server server = new smo.Server(sqlServer);
NotificationServices notificationServices = 
    server.NotificationServices;

// Get the Notification Services instance.
Instance nsinst = notificationServices.Instances[instanceName];

// If using encryption, set the argument key. The value
// must match the value used when creating the instance.
nsinst.ArgumentKey = "MyKey135711";

// Disable the instance.
Console.WriteLine("Disabling instance...");
nsinst.Disable();

// Get the application to update.
Application nsapp = nsinst.Applications[applicationName];

// Set the application's subscription throttle to 1000.
nsapp.SubscriptionThrottle = 1000;

// Update the instance of Notification Services.
// This can take a few minutes.
Console.WriteLine("Updating instance...");
nsinst.Update();

// Enable the instance.
Console.WriteLine("Enabling instance...");
nsinst.Enable();

// Generate new XML files.
Console.WriteLine("Exporting instance configuration...");
nsinst.Export(@"C:\NS\Full", true);
Console.WriteLine("Done.");
' Specify the Database Engine instance that hosts the 
' Notificaiton Services instance and get a reference to 
' the NotificationServices object.
Dim server As smo.Server = New smo.Server(sqlServer)
Dim notificationServices As NotificationServices = _
    server.NotificationServices

' Get the Notification Services instance.
Dim nsinst As Instance = _
    notificationServices.Instances(instanceName)

' If using encryption, set the argument key. The value
' must match the value used when creating the instance.
nsinst.ArgumentKey = "MyKey135711"

' Disable the instance.
Console.WriteLine("Disabling instance...")
nsinst.Disable()

' Get the application to update.
Dim nsapp As Application = nsinst.Applications(applicationName)

' Set the application's subscription throttle to 1000.
nsapp.SubscriptionThrottle = 1000

' Update the instance of Notification Services.
' This can take a few minutes.
Console.WriteLine("Updating instance...")
nsinst.Update()

' Enable the instance.
Console.WriteLine("Enabling instance...")
nsinst.Enable()

' Verify the change in XML (just for fun).
Console.WriteLine("Exporting instance configuration...")
nsinst.Export("C:\NS\Full\Update", True)
Console.WriteLine("Done.")

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

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

その他の技術情報

インスタンスとアプリケーションの更新
nscontrol update コマンド