ReplicationDatabase.WriteSubscriptionFailoverMode Method

Sets the failover mode for an updating subscription to a transactional or snapshot publication.

Namespace:  Microsoft.SqlServer.Replication
Assembly:  Microsoft.SqlServer.Rmo (in Microsoft.SqlServer.Rmo.dll)

Syntax

'Declaration
Public Sub WriteSubscriptionFailoverMode ( _
    publisher As String, _
    publicationDB As String, _
    publication As String, _
    failoverMode As FailoverMode _
)
'Usage
Dim instance As ReplicationDatabase
Dim publisher As String
Dim publicationDB As String
Dim publication As String
Dim failoverMode As FailoverMode

instance.WriteSubscriptionFailoverMode(publisher, _
    publicationDB, publication, failoverMode)
public void WriteSubscriptionFailoverMode(
    string publisher,
    string publicationDB,
    string publication,
    FailoverMode failoverMode
)
public:
void WriteSubscriptionFailoverMode(
    String^ publisher, 
    String^ publicationDB, 
    String^ publication, 
    FailoverMode failoverMode
)
member WriteSubscriptionFailoverMode : 
        publisher:string * 
        publicationDB:string * 
        publication:string * 
        failoverMode:FailoverMode -> unit 
public function WriteSubscriptionFailoverMode(
    publisher : String, 
    publicationDB : String, 
    publication : String, 
    failoverMode : FailoverMode
)

Parameters

Remarks

This method is only valid for databases subscribed to publications that support updatable subscriptions. Ensure that the AllowSyncToAlternate and AllowQueuedTransactions fields are enabled on the Attributes property for the TransPublication object to which this subscription belongs.

The WriteSubscriptionFailOverMode(String, String, String, FailoverMode) method can only be called by members of the sysadmin fixed server role and members of the db_owner fixed database role.

Calling WriteSubscriptionFailOverMode(String, String, String, FailoverMode) is equivalent to executing sp_setreplfailovermode (Transact-SQL).

This namespace, class, or member is supported only in version 2.0 of the .NET Framework.