• Article

Database.Collation Property

Gets or sets the default collation used by the database.

Namespace:  Microsoft.SqlServer.Management.Smo
Assembly:  Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)

Syntax

'Declaration
<SfcPropertyAttribute(SfcPropertyFlags.None Or SfcPropertyFlags.Expensive Or SfcPropertyFlags.Standalone Or SfcPropertyFlags.SqlAzureDatabase Or SfcPropertyFlags.Design,  _
    "SQL_Latin1_General_CP1_CI_AS")> _
Public Property Collation As String
    Get
    Set
'Usage
Dim instance As Database
Dim value As String

value = instance.Collation

instance.Collation = value

[SfcPropertyAttribute(SfcPropertyFlags.None|SfcPropertyFlags.Expensive|SfcPropertyFlags.Standalone|SfcPropertyFlags.SqlAzureDatabase|SfcPropertyFlags.Design, 
    "SQL_Latin1_General_CP1_CI_AS")]
public string Collation { get; set; }

[SfcPropertyAttribute(SfcPropertyFlags::None|SfcPropertyFlags::Expensive|SfcPropertyFlags::Standalone|SfcPropertyFlags::SqlAzureDatabase|SfcPropertyFlags::Design, 
    L"SQL_Latin1_General_CP1_CI_AS")]
public:
virtual property String^ Collation {
    String^ get () sealed;
    void set (String^ value) sealed;
}

[<SfcPropertyAttribute(SfcPropertyFlags.None|SfcPropertyFlags.Expensive|SfcPropertyFlags.Standalone|SfcPropertyFlags.SqlAzureDatabase|SfcPropertyFlags.Design, 
    "SQL_Latin1_General_CP1_CI_AS")>]
abstract Collation : string with get, set
[<SfcPropertyAttribute(SfcPropertyFlags.None|SfcPropertyFlags.Expensive|SfcPropertyFlags.Standalone|SfcPropertyFlags.SqlAzureDatabase|SfcPropertyFlags.Design, 
    "SQL_Latin1_General_CP1_CI_AS")>]
override Collation : string with get, set

final function get Collation () : String
final function set Collation (value : String)

Property Value

Type: System.String
A String value that specifies the name of the collation.

Implements

IDatabaseOptions.Collation

Remarks

You can find the available collation strings in Selecting a SQL Server Collation, by running the EnumCollations method, or during SQL Server setup. The collation string contains information about the code page, case-sensitivity, accent sensitivity, and language or alphabet.

Examples

VB

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server

'Reference the AdventureWorks2008R2 database.
Dim db As Database
db = srv.Databases("AdventureWorks2008R2")

'Display the current default collation.
Console.WriteLine(db.Collation)

'Display the case-sensitivity of the current collation.
Console.WriteLine("Collation is case-sensitive = " + _
db.CaseSensitive.ToString)

PowerShell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")
$db = New-Object Microsoft.SqlServer.Management.Smo.Database
$db = $srv.Databases.Item("AdventureWorks2008R2")
Write-Host "Collation is case-sensitive =" $db.CaseSensitive