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