Article.IdentityRangeThreshold Property

Article
12/03/2008

Gets or sets the value at which a new range of identity column values are assigned to a Publisher or to a Subscriber.

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

Syntax

'Declaration
Public Property IdentityRangeThreshold As Integer

public int IdentityRangeThreshold { get; set; }

public:
property int IdentityRangeThreshold {
    int get ();
    void set (int value);
}

/** @property */
public int get_IdentityRangeThreshold ()

/** @property */
public void set_IdentityRangeThreshold (int value)

public function get IdentityRangeThreshold () : int

public function set IdentityRangeThreshold (value : int)

Property Value

An Int32 value between 1 and 100 that specifies the percentage of the total identity range that must be used before a new range of identity values is assigned.

Remarks

You must specify a value for IdentityRangeThreshold when IdentityRangeManagementOption is Automatic.

The IdentityRangeThreshold property can be retrieved by members of the sysadmin fixed server role at the Publisher and at the Subscriber (for republishing Subscribers). It can also be retrieved by members of the db_owner fixed database role on the publication database and by users who are members of the PAL. For a MergeArticle object, this property can also be retrieved by members of the replmonitor fixed database role on the Distributor.

The IdentityRangeThreshold property can be set by members of the sysadmin fixed server role at the Publisher. It can also be set by members of the db_owner fixed database role on the publication database.

Retrieving IdentityRangeThreshold is equivalent to executing sp_helparticle (Transact-SQL) for transactional or snapshot replication or executing sp_helpmergearticle (Transact-SQL) for merge replication.

Setting IdentityRangeThreshold is equivalent to executing sp_addarticle (Transact-SQL) or sp_changearticle (Transact-SQL) for transactional or snapshot replication or executing sp_addmergearticle (Transact-SQL) or sp_changemergearticle (Transact-SQL) for merge replication.

The IdentityRangeThreshold property is available with SQL Server 2005 and SQL Server 2000.

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

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