Edit

Share via


BamlLocalizer Class

Definition

Extracts resources from a BAML file and generates a localized version of a BAML source.

public ref class BamlLocalizer
public class BamlLocalizer
type BamlLocalizer = class
Public Class BamlLocalizer
Inheritance
BamlLocalizer

Examples

The following example demonstrates how to use a BamlLocalizer.


// Obtain the BAML stream.
Stream source = entry.Value as Stream;

// Create a BamlLocalizer on the stream.
BamlLocalizer localizer = new BamlLocalizer(source);
BamlLocalizationDictionary resources = localizer.ExtractResources();

// Write out all the localizable resources in the BAML.
foreach (DictionaryEntry resourceEntry in resources)
{
    BamlLocalizableResourceKey key = resourceEntry.Key as BamlLocalizableResourceKey;
    BamlLocalizableResource value = resourceEntry.Value as BamlLocalizableResource;
    Console.WriteLine(
        "    {0}.{1}.{2} = {3}",
        key.Uid,
        key.ClassName,
        key.PropertyName,
        value.Content
        );                                
}

' Obtain the BAML stream.
Dim source As Stream = TryCast(entry.Value, Stream)

' Create a BamlLocalizer on the stream.
Dim localizer As New BamlLocalizer(source)
Dim resources As BamlLocalizationDictionary = localizer.ExtractResources()

' Write out all the localizable resources in the BAML.
For Each resourceEntry As DictionaryEntry In resources
    Dim key As BamlLocalizableResourceKey = TryCast(resourceEntry.Key, BamlLocalizableResourceKey)
    Dim value As BamlLocalizableResource = TryCast(resourceEntry.Value, BamlLocalizableResource)
    Console.WriteLine("    {0}.{1}.{2} = {3}", key.Uid, key.ClassName, key.PropertyName, value.Content)
Next resourceEntry

Remarks

This class is the primary entry point to the BAML localization API. You must create an instance of this class for each BAML source that you localize.

Constructors

BamlLocalizer(Stream)

Initializes a new instance of the BamlLocalizer class with the specified BAML source stream.

BamlLocalizer(Stream, BamlLocalizabilityResolver)

Initializes a new instance of the BamlLocalizer class with the specified localizability resolver and BAML source stream.

BamlLocalizer(Stream, BamlLocalizabilityResolver, TextReader)

Initializes a new instance of the BamlLocalizer class with the specified localizability resolver, BAML source stream, and TextReader.

Methods

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExtractResources()

Extracts all localizable resources from a BAML stream.

GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
OnErrorNotify(BamlLocalizerErrorNotifyEventArgs)

Raises the ErrorNotify event.

ToString()

Returns a string that represents the current object.

(Inherited from Object)
UpdateBaml(Stream, BamlLocalizationDictionary)

Applies resource updates to the BAML source and writes the updated version to a specified stream in order to create a localized version of the source BAML.

Events

ErrorNotify

Occurs when the BamlLocalizer encounters abnormal conditions.

Applies to

See also