Version: Unity 6.7 Alpha (6000.7)
LanguageEnglish
  • C#

LocalizedEntry<T0>

class in Unity.Localization

/

Inherits from:Unity.Localization.LocalizedReference

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Description

A serializable reference to a single localization table entry that resolves to a typed entry value.

A LocalizedEntry<T0> pairs the LocalizedReference.TableReference inherited from LocalizedReference with a TableEntryReference, then resolves the entry as TEntry. When LocalizedReference.EnableFallback is set, resolution follows the locale fallback chain. Lookups go through the ResourceDatabase provider chain: call LocalizedEntry<T0>.GetEntryAsync to load on demand, or LocalizedEntry<T0>.GetEntry to read from already-loaded tables. The LocalizedString and LocalizedAsset<T0> types derive from typed versions of this class. Read the raw entry directly to inspect variants or metadata that the higher-level types do not expose.

Additional resources: LocalizedString, LocalizedAsset<T0>, TableEntryReference, ResourceDatabase

<para>Resolve the raw entry for a reference and read its value.</para>

using Unity.Localization;
using UnityEngine;

namespace Unity.Localization.Samples { public class LocalizedEntryResolveExample { public async Awaitable Resolve() { var reference = new LocalizedString(); reference.SetReference("My Strings", "HELLO"); IStringEntry entry = await reference.GetEntryAsync(); if (entry != null) Debug.Log(entry.Value); } } }

Properties

Property Description
IsEmpty Whether this reference is unset and resolves to no value.
TableEntryReference The entry within the table collection that this reference resolves.

Public Methods

Method Description
GetEntry Resolves the entry synchronously from already-loaded tables without triggering a load.
GetEntryAsync Resolves the entry asynchronously, loading the table if it is not already available.
SetReference Sets the table and entry references together so the reference refreshes only once.

Inherited Members

Properties

PropertyDescription
isDirty When set to true, the binding instance updates during the next update cycle. When set to false, the binding instance updates only if a change is detected.
updateTrigger When set to BindingUpdateTrigger.EveryUpdate, the binding instance updates in every update, regardless of the data source version.
EnableFallback Whether to walk the locale fallback chain when the resolving locale has no value for this reference.
HasLocaleOverride Whether a locale override is set on this reference.
IsEmpty Whether this reference is unset and resolves to no value.
LocaleOverride The locale used to resolve this reference instead of the locale selected in the project settings.
TableReference The localization table collection that this reference resolves against.

Public Methods

MethodDescription
MarkDirty Notifies the binding system to process this binding.
OnActivated Called when the binding becomes active for a specific VisualElement.
OnDataSourceChanged Called when the resolved data source of a binding changes.
OnDeactivated Called when the binding is no longer active for a specific VisualElement.
Update Called when the binding system updates the binding.
OnActivated Starts resolving the reference when it becomes active on an element.
OnDeactivated Stops resolving the reference once it is no longer active on any element.
Update Writes the resolved value to the bound field.

Protected Methods

MethodDescription
ForceUpdate Called when the reference changes so subclasses can refresh any live listeners.
ResolveOverrideLocale Resolves the override locale from the project settings for subclasses to pass to the resource database.

Static Methods

MethodDescription
GetGlobalLogLevel Gets the global log level for all binding failures.
GetPanelLogLevel Gets the log level for binding failures on a panel.
ResetPanelLogLevel Resets the log level for binding failures on a panel to use the global setting.
SetGlobalLogLevel Sets the log level for all binding failures.
SetPanelLogLevel Sets the log level for binding failures on a panel.