IDbCollationProperties.GetCollationProperties Method

Artigo
12/03/2008

Returns the collation properties used for a connection.

Namespace: Microsoft.ReportingServices.DataProcessing
Assembly: Microsoft.ReportingServices.Interfaces (in microsoft.reportingservices.interfaces.dll)

Syntax

'Declaration
<StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey:="0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")> _
Function GetCollationProperties ( _
    <OutAttribute> ByRef cultureName As String, _
    <OutAttribute> ByRef caseSensitive As Boolean, _
    <OutAttribute> ByRef accentSensitive As Boolean, _
    <OutAttribute> ByRef kanatypeSensitive As Boolean, _
    <OutAttribute> ByRef widthSensitive As Boolean _
) As Boolean

[StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey="0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")] 
bool GetCollationProperties (
    out string cultureName,
    out bool caseSensitive,
    out bool accentSensitive,
    out bool kanatypeSensitive,
    out bool widthSensitive
)

[StrongNameIdentityPermissionAttribute(SecurityAction::LinkDemand, PublicKey=L"0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")] 
bool GetCollationProperties (
    [OutAttribute] String^% cultureName, 
    [OutAttribute] bool% caseSensitive, 
    [OutAttribute] bool% accentSensitive, 
    [OutAttribute] bool% kanatypeSensitive, 
    [OutAttribute] bool% widthSensitive
)

/** @attribute StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey="0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8") */ 
boolean GetCollationProperties (
    /** @attribute OutAttribute() */ /** @ref */ String cultureName, 
    /** @attribute OutAttribute() */ /** @ref */ boolean caseSensitive, 
    /** @attribute OutAttribute() */ /** @ref */ boolean accentSensitive, 
    /** @attribute OutAttribute() */ /** @ref */ boolean kanatypeSensitive, 
    /** @attribute OutAttribute() */ /** @ref */ boolean widthSensitive
)

JScript does not support passing value-type arguments by reference.

Parameters

cultureName
The name of the culture to use for collation.

caseSensitive
Indicates that the collation should be case sensitive.

accentSensitive
Indicates that the collation should be accent sensitive.

kanatypeSensitive
Indicates that the collation should be kana type sensitive.

widthSensitive
Indicates that the collation should be width sensitive.

Return Value

Returns true if the collation properties could be detected for the current connection.

Remarks

This method returns the collation properties used for a connection. These property values can be used in reports which request auto-detected collation properties.

A data processing extension needs to execute one or more queries against a data source in order to determine the default collation properties. In order to execute queries from within the data extension, transactions need to be taken into account. For some managed data providers, the transaction property on a command must be explicitly set if the connection is in a transaction, even if the command was created using CreateCommand. To do this, you must cache the transaction when BeginTransaction is called, and release the transaction on Commit or Rollback.

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms