Subscription.SubscriptionId Property

Articolo
12/15/2008

Gets or sets the subscription identifier for a subscription record.

Spazio dei nomi: Microsoft.SqlServer.NotificationServices
Assembly : Microsoft.SqlServer.NotificationServices (in microsoft.sqlserver.notificationservices.dll)

Sintassi

'Dichiarazione
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)

Valore proprietà

A String containing the subscription ID for this subscription.

Osservazioni

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.

Esempio

' 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();

Thread Safety

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.

Piattaforme

Piattaforme di sviluppo

Per un elenco delle piattaforme supportate, vedere Requisiti hardware e software per l'Installazione di SQL Server 2005.

Piattaforme di destinazione