SqlCeReplication.ProfileName Property

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)

Not applicable.

Property Value

The agent profile name.

Remarks

A profile defines behavior, such as time-out 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 Compact Edition clients who share a profile and you want to change the query time-out value, you change the QueryTimeout value in the profile and all SQL Server Compact Edition clients will use the new QueryTimeout value.

You can also create different profiles for different SQL Server Compact Edition clients. For example, a SQL Server Compact Edition client that uses a dial-up Internet connection might use one time-out value while a client that uses a high-speed intranet connection might use a different time-out 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.

Platforms

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0

.NET Compact Framework

Supported in: 2.0, 1.0

See Also

Reference

SqlCeReplication Class
SqlCeReplication Members
System.Data.SqlServerCe Namespace