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
    Get
    Set
'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);
}
member ProfileName : string with get, set
function get ProfileName () : String
function set ProfileName (value : String)

Property Value

Type: System. . :: . .String
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 Reconciler. For example, the profile specifies the LoginTimeout and QueryTimeout values used by the 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 Books Online.

The profile allows you to easily change key parameters for synchronization. For example, if you have five 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 clients will use the new QueryTimeout value.

You can also create different profiles for different clients. For example, a  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.

See Also

Reference

SqlCeReplication Class

SqlCeReplication Members

System.Data.SqlServerCe Namespace