SqlCeReplication.ProfileName Property

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

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

  [Visual Basic]
  Public Property ProfileName As String
[C#]
public string ProfileName {get; set;}
[C++]
public: __property String* get_ProfileName();
public: __property void set_ProfileName(String*);
[JScript]
public function get ProfileName() : String;
public function set ProfileName(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 CE 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 CE clients will use the new QueryTimeOut value.

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

Requirements

Platforms: .NET Compact Framework

.NET Framework Security:

See Also

SqlCeReplication Class | SqlCeReplication Members | System.Data.SqlServerCe Namespace

Syntax based on .NET Framework version 1.1.
Documentation version 1.1.1.

Send comments on this topic.

© Microsoft Corporation. All rights reserved.