SqlCeReplication.ProfileName Property

Article
10/22/2007

Specifies the name of the agent profile at the Distributor to be used by the SqlCeReplication object.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Syntax

'Declaration
Public Property ProfileName As String
'Usage
Dim instance As SqlCeReplication
Dim value As String

value = instance.ProfileName

instance.ProfileName = value

public string ProfileName { get; set;

public:
property String^ ProfileName {
    String^ get ();
    void set (String^ value);

/** @property */
public String get_ProfileName ()

/** @property */
public void set_ProfileName (String value)

public function get ProfileName () : String

public function set ProfileName (value : String)

Property Value

The agent profile name.

Remarks

A profile defines behavior, such as timeout values. You can override the default values by creating a profile on the Distributor and specifying its name through the ProfileName property.

A profile contains a set of parameters that control the behavior of the SQL Server Reconciler. For example, the profile specifies the LoginTimeout and QueryTimeout values used by the SQL Server Reconciler. The profile is stored on the Distributor. The profile is read each time a subscription is synchronized. For more information, see "Agent Profiles" in SQL Server Books Online.

The profile allows you to easily change key parameters for synchronization. For example, if you have five SQL Server Mobile clients who share a profile and you want to change the query timeout value, you change the QueryTimeOut value in the profile and all SQL Server Mobile clients will use the new QueryTimeOut value.

You can also create different profiles for different SQL Server Mobile clients. For example, a SQL Server Mobile client that uses a dial-up Internet connection might use one timeout value while a client that uses a high-speed intranet connection might use a different timeout value. The ProfileName property is used to specify the name of the profile.

If the ProfileName property is not specified, the default profile values are used.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see .

Platforms

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Version Information

.NET Compact Framework

Supported in: 2.0, 1.0