Subscription.GetFieldValue Method

Article
12/03/2008

Returns the value of a field in the subscription record.

Namespace: Microsoft.SqlServer.NotificationServices
Assembly: Microsoft.SqlServer.NotificationServices (in microsoft.sqlserver.notificationservices.dll)

Syntax

'Declaration
Public Function GetFieldValue ( _
    fieldName As String _
) As Object

public Object GetFieldValue (
    string fieldName
)

public:
virtual Object^ GetFieldValue (
    String^ fieldName
) sealed

public final Object GetFieldValue (
    String fieldName
)

public final function GetFieldValue (
    fieldName : String
) : Object

Parameters

fieldName
The name of the subscription field for which you want the value returned.

Return Value

An Object that represents the value of the field.

Remarks

This method is provided for COM interoperability, to allow callers from unmanaged code to get field values from a subscription record. Managed callers do not use this method.

Example

The following example shows how to use the GetFieldValue method in unmanaged Microsoft Visual Basic Scripting Edition (VBScript) code to get the value of a subscription field:

Dim myInstance, myApplication, mySubscription, fieldValue

const instanceName = "MyInstanceName"
const applicationName = "MyApplicationName"
const subscriptionClassName = "MySubscriptionClassName"
const fieldName = "MySubscriptionFieldName"

'Create & initialize an NSInstance object.
set myInstance = WScript.CreateObject("Microsoft.SqlServer.NotificationServices.NSInstance")
myInstance.Initialize instanceName

'Create & initialize an NSApplication object.
set myApplication = WScript.CreateObject("Microsoft.SqlServer.NotificationServices.NSApplication")
myApplication.Initialize (myInstance), applicationName

'Create & initialize a Subscription object.
set mySubscription= WScript.CreateObject("Microsoft.SqlServer.NotificationServices.Subscription")
mySubscription.Initialize (myApplication), subscriptionClassName

mySubscription.SubscriptionId = "1"

fieldValue = mySubscription.GetFieldValue(fieldName)

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.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms