IExtension.LocalizedName Property

Article
12/03/2008

Gets the localized name of the extension to be displayed in a user interface.

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

Syntax

'Declaration
<StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey:="0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")> _
ReadOnly Property LocalizedName As String

[StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey="0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")] 
string LocalizedName { get; }

[StrongNameIdentityPermissionAttribute(SecurityAction::LinkDemand, PublicKey=L"0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")] 
property String^ LocalizedName {
    String^ get ();
}

/** @property */
/** @attribute StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey="0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8") */ 
String get_LocalizedName ()

function get LocalizedName () : String

Property Value

The localized name of the extension.

Remarks

The LocalizedName property is called by the report server to retrieve the localized name of the extension. Your extension should set the localized name based on the locale of the calling thread. You can use the CultureInfo class in System.Globalization namespace to discover the locale settings of the thread. For more information, see "System.Globalization Namespace" in the Microsoft .NET Framework SDK documentation.

Note

A Reporting Services extension class should always provide the LocalizedNameAttribute attribute. If the LocalizedNameAttribute attribute has not been applied to the extension class, the Reporting Services engine will attempt to examine the LocalizedName property of the extension class; because this requires constructing an instance of the extension, this may incur a performance penalty.

Example

The following code snippet shows the LocalizedNameAttribute being set on an extension class:

[C#]

namespace PolygonsCRI

{

[LocalizedName("Polygons")]

[Editor(typeof(CustomEditor), typeof(ComponentEditor))]

[ToolboxBitmap(typeof(PolygonsDesigner),"Polygons.ico")]

// this CRI-specific attribute sets the name of the

// custom report item which is referenced by the config

// files and saved in the report definition language

[CustomReportItem("Polygons")]

// the main class for our CRI design-time component

public class PolygonsDesigner : CustomReportItemDesigner

{

...

}

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