Subscription.SubscriptionId Property

Статья
12/15/2008

Gets or sets the subscription identifier for a subscription record.

Пространство имен: Microsoft.SqlServer.NotificationServices
Сборка: Microsoft.SqlServer.NotificationServices (in microsoft.sqlserver.notificationservices.dll)

Синтаксис

'Декларация
Public Property SubscriptionId As String

public string SubscriptionId { get; set; }

public:
virtual property String^ SubscriptionId {
    String^ get () sealed;
    void set (String^ value) sealed;
}

/** @property */
public final String get_SubscriptionId ()

/** @property */
public final void set_SubscriptionId (String value)

public final function get SubscriptionId () : String

public final function set SubscriptionId (value : String)

Значение свойства

A String containing the subscription ID for this subscription.

Замечания

When a new subscription is added to the database, Notification Services assigns it a unique subscription ID. Notification Services components use this subscription ID to identify the subscription.

Setting the subscription ID in a procedure causes all subsequent update and delete actions to be performed on the record identified by the subscription ID that was set, and not on the record that was originally retrieved.

Пример

' Create the NSInstance object.
Dim testInstance As New NSInstance("Tutorial")
 
' Create the NSApplication object.
Dim testApplication As _
    New NSApplication(testInstance, "Weather")
 
' Create the Subscription object.
Dim testSubscription As _
    New Subscription(testApplication, "WeatherCity")
 
 
'Create a SubscriptionEnumeration object.
' that contains all of the subscriber's subscriptions
' in a specific subscription class
Dim testSubscriptionEnumeration As _
    New SubscriptionEnumeration(testApplication, "WeatherCity", "TestUser1")
 
'Iterate through the subscriptions, finding the subscription
' to match. In a user interface, you would probably list the 
' subscriptions in a list box and then let the user
' alter the data for the selected subscription
Dim subscription As Subscription
For Each subscription In testSubscriptionEnumeration
    Dim city As String =  subscription.GetFieldValue("City").ToString() 
    Console.WriteLine(city)
    Console.WriteLine("Subscription ID: {0}", subscription.SubscriptionId)
    If city.Equals("Shoreline") Then
         testSubscription.SubscriptionId = subscription.SubscriptionId
    End If
Next
 
' Set all of the subscription data fields 
testSubscription("DeviceName") = "Work e-mail"
testSubscription("SubscriberLocale") = "en-US"
testSubscription("City") = "Edmonds"
 
testSubscription.Update()

// Create the NSInstance object.
NSInstance testInstance = new NSInstance("Tutorial");

// Create the NSApplication object.
NSApplication testApplication =
    new NSApplication(testInstance, "Weather");

// Create the Subscription object.
Subscription testSubscription =
    new Subscription(testApplication, "WeatherCity");


//Create a SubscriptionEnumeration object.
// that contains all of the subscriber's subscriptions
// in a specific subscription class
SubscriptionEnumeration testSubscriptionEnumeration = 
    new SubscriptionEnumeration(testApplication, 
        "WeatherCity", "TestUser1");

//Iterate through the subscriptions, finding the subscription
// to match. In a user interface, you would probably list the 
// subscriptions in a list box and then let the user
// alter the data for the selected subscription
foreach (Subscription subscription in testSubscriptionEnumeration)
{
    String city = subscription.GetFieldValue("City").ToString();
    Console.WriteLine(city);
    Console.WriteLine("Subscription ID: {0}", subscription.SubscriptionId);
        if (city.Equals("Shoreline"))
            testSubscription.SubscriptionId = subscription.SubscriptionId;
}

// Set all of the subscription data fields 
testSubscription["DeviceName"] = "Work e-mail";
testSubscription["SubscriberLocale"] = "en-US";
testSubscription["City"] = "Edmonds";

testSubscription.Update();

Синхронизация потоков

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Платформы

Платформы разработки

Список поддерживаемых платформ см. в разделе Hardware and Software Requirements for Installing SQL Server 2005.

Целевые платформы