Article
11/18/2011

ResourceManager Constructor (String, Assembly, Type)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Updated: October 2010

Initializes a new instance of the ResourceManager class that looks up resources contained in files derived from the specified root name using the given Assembly.

Namespace: System.Resources
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Sub New ( _
    baseName As String, _
    assembly As Assembly, _
    usingResourceSet As Type _
)

public ResourceManager(
    string baseName,
    Assembly assembly,
    Type usingResourceSet
)

Parameters

baseName
Type: System.String
The root name of the resource file without its extension and along with any fully qualified namespace name. For example, the root name for the resource file named "MyApplication.MyResource.en-US.resources" is "MyApplication.MyResource".

assembly
Type: System.Reflection.Assembly
The main assembly for the resources.

usingResourceSet
Type: System.Type
The type of the custom ResourceSet to use. If nulla null reference (Nothing in Visual Basic), the default runtime ResourceSet object is used.

Exceptions

Exception	Condition
ArgumentException	usingResourceset is not a derived class of ResourceSet.
ArgumentNullException	The baseName or assembly parameter is nulla null reference (Nothing in Visual Basic).

Remarks

The individual resource files should be contained in satellite assemblies with the invariant culture's .resources file contained in the main assembly. A satellite assembly is assumed to contain resources for a single culture specified in that assembly's manifest, and are loaded as necessary.

If the resource file identified by baseName cannot be found in assembly, the method instantiates a ResourceManager object, but the attempt to retrieve a specific resource throws an exception, typically a MissingManifestResourceException.

You can specify a ResourceSet implementation to be used. If you do not need a specific ResourceSet implementation but would like to use a custom resource file format, you should derive from the ResourceSet class, override the GetDefaultReader method, and pass that type to this constructor.

Note:
The usingResourceSet parameter is used to support your own resource format, and will commonly be nulla null reference (Nothing in Visual Basic). This is different from the constructor that takes a Type only.

Platform Notes

Silverlight for Windows Phone

ResourceManager(String, Assembly, Type), throws NotSupportedException when the usingResourceSet parameter is null..

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Change History

Date	History	Reason
October 2010	Expanded the baseName parameter description and the Remarks section.	Customer feedback.

Partager via