CollationName Property

  • Article

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The CollationName property retrieves or sets the collation name of a linked server.

Syntax

object
.CollationName [=value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list
  • value
    A string that specifies a valid collation name

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetCollationName(SQLDMO_LPBSTR pRetVal);
HRESULT SetCollationName(SQLDMO_LPCSTR NewValue);

Remarks

If CollationName is not set, the default collation is used. If set to the default collation, CollationName returns NULL. Prior to setting the CollationName property, use the ListCollations method to retrieve a list of valid collation names. Setting CollationName to NULL or an empty string results in setting the collation back to the default.

Note

If an application calls CollationName on an instance of Microsoft SQL Server version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000 or later" are returned.

Applies To:

LinkedServer2 Object