ResourceBundle.GetBundle Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| GetBundle(String) |
Obtiene un conjunto de recursos mediante el nombre base especificado, la configuración regional predeterminada y el cargador de clases del autor de la llamada. |
| GetBundle(String, Locale) |
Obtiene un conjunto de recursos mediante el nombre base y la configuración regional especificados, y el cargador de clases del autor de la llamada. |
| GetBundle(String, ResourceBundle+Control) |
Obtiene un conjunto de recursos mediante el nombre base especificado, la configuración regional predeterminada y el cargador de clases del autor de la llamada. |
| GetBundle(String, Locale, ClassLoader) |
Obtiene un conjunto de recursos mediante el nombre base, la configuración regional y el cargador de clases especificados. |
| GetBundle(String, Locale, ResourceBundle+Control) |
Obtiene un conjunto de recursos mediante el nombre base especificado, la configuración regional predeterminada y el cargador de clases del autor de la llamada. |
| GetBundle(String, Locale, ClassLoader, ResourceBundle+Control) |
Obtiene un conjunto de recursos mediante el nombre base especificado, la configuración regional predeterminada y el cargador de clases del autor de la llamada. |
GetBundle(String)
Obtiene un conjunto de recursos mediante el nombre base especificado, la configuración regional predeterminada y el cargador de clases del autor de la llamada.
[Android.Runtime.Register("getBundle", "(Ljava/lang/String;)Ljava/util/ResourceBundle;", "")]
public static Java.Util.ResourceBundle? GetBundle (string? baseName);
[<Android.Runtime.Register("getBundle", "(Ljava/lang/String;)Ljava/util/ResourceBundle;", "")>]
static member GetBundle : string -> Java.Util.ResourceBundle
Parámetros
- baseName
- String
el nombre base del conjunto de recursos, un nombre de clase completo
Devoluciones
un lote de recursos para el nombre base especificado y la configuración regional predeterminada
- Atributos
Excepciones
si no se encuentra .ResourceBundle
Comentarios
Obtiene un conjunto de recursos mediante el nombre base especificado, la configuración regional predeterminada y el cargador de clases del autor de la llamada. Llamar a este método es equivalente a llamar a <blockquote>getBundle(baseName, Locale.getDefault(), this.getClass().getClassLoader()), </blockquote>
Documentación de Java para java.util.ResourceBundle.getBundle(java.lang.String).
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.
Se aplica a
GetBundle(String, Locale)
Obtiene un conjunto de recursos mediante el nombre base y la configuración regional especificados, y el cargador de clases del autor de la llamada.
[Android.Runtime.Register("getBundle", "(Ljava/lang/String;Ljava/util/Locale;)Ljava/util/ResourceBundle;", "")]
public static Java.Util.ResourceBundle? GetBundle (string? baseName, Java.Util.Locale? locale);
[<Android.Runtime.Register("getBundle", "(Ljava/lang/String;Ljava/util/Locale;)Ljava/util/ResourceBundle;", "")>]
static member GetBundle : string * Java.Util.Locale -> Java.Util.ResourceBundle
Parámetros
- baseName
- String
el nombre base del conjunto de recursos, un nombre de clase completo
- locale
- Locale
configuración regional para la que se desea un conjunto de recursos
Devoluciones
un conjunto de recursos para el nombre base y la configuración regional especificados
- Atributos
Excepciones
si no se encuentra el conjunto de recursos.
Comentarios
Obtiene un conjunto de recursos mediante el nombre base y la configuración regional especificados, y el cargador de clases del autor de la llamada. Llamar a este método es equivalente a llamar a <blockquote>getBundle(baseName, locale, this.getClass().getClassLoader()), </blockquote>
Documentación de Java para java.util.ResourceBundle.getBundle(java.lang.String, java.util.Locale).
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.
Se aplica a
GetBundle(String, ResourceBundle+Control)
Obtiene un conjunto de recursos mediante el nombre base especificado, la configuración regional predeterminada y el cargador de clases del autor de la llamada.
[Android.Runtime.Register("getBundle", "(Ljava/lang/String;Ljava/util/ResourceBundle$Control;)Ljava/util/ResourceBundle;", "")]
public static Java.Util.ResourceBundle? GetBundle (string? baseName, Java.Util.ResourceBundle.Control? control);
[<Android.Runtime.Register("getBundle", "(Ljava/lang/String;Ljava/util/ResourceBundle$Control;)Ljava/util/ResourceBundle;", "")>]
static member GetBundle : string * Java.Util.ResourceBundle.Control -> Java.Util.ResourceBundle
Parámetros
- baseName
- String
el nombre base del conjunto de recursos, un nombre de clase completo
- control
- ResourceBundle.Control
control que controla la secuencia de acceso
Devoluciones
un lote de recursos para el nombre base especificado y la configuración regional predeterminada
- Atributos
Comentarios
Documentación de Java para java.util.ResourceBundle.getBundle(java.lang.String).
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.
Se aplica a
GetBundle(String, Locale, ClassLoader)
Obtiene un conjunto de recursos mediante el nombre base, la configuración regional y el cargador de clases especificados.
[Android.Runtime.Register("getBundle", "(Ljava/lang/String;Ljava/util/Locale;Ljava/lang/ClassLoader;)Ljava/util/ResourceBundle;", "")]
public static Java.Util.ResourceBundle? GetBundle (string? baseName, Java.Util.Locale? locale, Java.Lang.ClassLoader? loader);
[<Android.Runtime.Register("getBundle", "(Ljava/lang/String;Ljava/util/Locale;Ljava/lang/ClassLoader;)Ljava/util/ResourceBundle;", "")>]
static member GetBundle : string * Java.Util.Locale * Java.Lang.ClassLoader -> Java.Util.ResourceBundle
Parámetros
- baseName
- String
el nombre base del conjunto de recursos, un nombre de clase completo
- locale
- Locale
configuración regional para la que se desea un conjunto de recursos
- loader
- ClassLoader
el cargador de clases desde el que se va a cargar el conjunto de recursos.
Devoluciones
un conjunto de recursos para el nombre base y la configuración regional especificados
- Atributos
Excepciones
si no se encuentra .ResourceBundle
Comentarios
Obtiene un conjunto de recursos mediante el nombre base, la configuración regional y el cargador de clases especificados.
Esto equivale a llamar a: <blockquote>
getBundle(baseName, targetLocale, loader, control)
</blockquote> pasando una instancia predeterminada de Control. Consulte la descripción de la modificación del comportamiento predeterminado. A continuación se describe el comportamiento predeterminado.
<b>"default_behavior">Estrategia de búsqueda y carga< de paquetes de recursos/b>
getBundleusa el nombre base, la configuración regional especificada y la configuración regional predeterminada (obtenida de java.util.Locale#getDefault() Locale.getDefault) para generar una secuencia de nombres de agrupación< de candidatos><>/em>. Si el idioma, el script, el país y la variante de la configuración regional especificados son todas las cadenas vacías, el nombre base es el único nombre de lote candidato. De lo contrario, se genera una lista de configuraciones regionales candidatas a partir de los valores de atributo de la configuración regional especificada (idioma, script, país y variante) y se anexa al nombre base. Normalmente, esto tendrá un aspecto similar al siguiente:
baseName + "_" + language + "_" + script + "_" + country + "_" + variant
baseName + "_" + language + "_" + script + "_" + country
baseName + "_" + language + "_" + script
baseName + "_" + language + "_" + country + "_" + variant
baseName + "_" + language + "_" + country
baseName + "_" + language
Se omiten los nombres de agrupación candidatos en los que el componente final es una cadena vacía, junto con el carácter de subrayado. Por ejemplo, si country es una cadena vacía, se omitirán el segundo y el quinto nombre de lote candidato anterior. Además, si el script es una cadena vacía, se omiten los nombres candidatos, incluido el script. Por ejemplo, una configuración regional con el lenguaje "de" y la variante "JAVA" generarán nombres candidatos con el nombre base "MyResource" a continuación.
MyResource_de__JAVA
MyResource_de
En caso de que la variante contenga uno o más caracteres ('_') de subrayado, una secuencia de nombres de agrupación generados truncando el último carácter de subrayado y la parte siguiente se inserta después de un nombre de lote candidato con la variante original. Por ejemplo, para una configuración regional con el idioma "en", script "Latn, country "US" y variant "WINDOWS_VISTA" y bundle base name "MyResource", se genera la lista de nombres de agrupación candidatos a continuación:
MyResource_en_Latn_US_WINDOWS_VISTA
MyResource_en_Latn_US_WINDOWS
MyResource_en_Latn_US
MyResource_en_Latn
MyResource_en_US_WINDOWS_VISTA
MyResource_en_US_WINDOWS
MyResource_en_US
MyResource_en
<blockquote><b>Note:</b> For some Locales, the list of candidate bundle names contains extra names, or the order of bundle names is ligeramente modified. Consulte la descripción de la implementación predeterminada de Control#getCandidateLocales(String, Locale) getCandidateLocales para obtener más información.</blockquote>
getBundlea continuación, recorre en iteración los nombres de agrupación candidatos para buscar el primero para el que puede <crear<> instancias de un> lote de recursos real. Usa el método de Control#getFormats getFormats los controles predeterminados, que genera dos nombres de agrupación para cada nombre generado, el primero un nombre de clase y el segundo un nombre de archivo de propiedades. Para cada nombre de lote candidato, intenta crear un lote de recursos:
<ul><li>First, intenta cargar una clase con el nombre de clase generado. Si se puede encontrar y cargar dicha clase mediante el cargador de clases especificado, es compatible con la asignación compatible con ResourceBundle, es accesible desde ResourceBundle y se puede crear una instancia de esta clase, getBundle crea una nueva instancia de esta clase y la usa como agrupación <<de recursos de resultado em>/em>.
<li>De lo contrario, getBundle intenta localizar un archivo de recursos de propiedad mediante el nombre del archivo de propiedades generado. Genera un nombre de ruta de acceso del nombre de lote candidato reemplazando todos los caracteres "." por "/" y anexando la cadena ".properties". Intenta encontrar un "recurso" con este nombre mediante java.lang.ClassLoader#getResource(java.lang.String) ClassLoader.getResource. (Tenga en cuenta que un "recurso" en el sentido de getResource no tiene nada que ver con el contenido de un conjunto de recursos, es simplemente un contenedor de datos, como un archivo). Si encuentra un "recurso", intenta crear una nueva PropertyResourceBundle instancia a partir de su contenido. Si se ejecuta correctamente, esta instancia se convierte en la <agrupación< de recursos em>result/em>. </ul>
Esto continúa hasta que se crea una instancia de una agrupación de recursos de resultados o se agota la lista de nombres de agrupación candidatos. Si no se encuentra ninguna agrupación de recursos coincidente, se llama al método del Control#getFallbackLocale getFallbackLocale control predeterminado, que devuelve la configuración regional predeterminada actual. Se genera una nueva secuencia de nombres de configuración regional candidatos mediante esta configuración regional y se vuelve a buscar, como se ha indicado anteriormente.
Si todavía no se encuentra ninguna agrupación de resultados, se busca el nombre base por sí solo. Si sigue produciendo un error, se produce una MissingResourceException excepción .
"parent_chain"> Una vez que se ha encontrado un paquete de recursos de resultado, se crea una instancia de su <>cadena< primaria/em>. Si la agrupación de resultados ya tiene un elemento primario (quizás porque se devolvió de una memoria caché), la cadena está completa.
De lo contrario, getBundle examina el resto de la lista de configuración regional candidata que se usó durante el paso que generó el conjunto de recursos de resultados. (Como antes, se omiten los nombres de agrupación candidatos donde el componente final es una cadena vacía). Cuando se trata del final de la lista de candidatos, intenta el nombre del lote sin formato. Con cada uno de los nombres de agrupación candidatos, intenta crear instancias de un lote de recursos (primero busca una clase y, a continuación, un archivo de propiedades, como se ha descrito anteriormente).
Siempre que se realice correctamente, llama al método del conjunto de #setParent(java.util.ResourceBundle) setParent recursos creado anteriormente con el nuevo lote de recursos. Esto continúa hasta que se agota la lista de nombres o la agrupación actual ya tiene un elemento primario no NULL.
Una vez completada la cadena primaria, se devuelve la agrupación.
<b>Nota:</b>getBundle almacena en caché agrupaciones de recursos con instancias y podría devolver la misma instancia de lote de recursos varias veces.
<b>Nota:</b>El baseName argumento debe ser un nombre de clase completo. Sin embargo, para la compatibilidad con versiones anteriores, los entornos en tiempo de ejecución de Java SE no comprueban esto, por lo que es posible acceder PropertyResourceBundlea s especificando un nombre de ruta de acceso (mediante "/") en lugar de un nombre de clase completo (mediante ".").
"default_behavior_example"><ejemplo seguro>:</strong>
Se proporcionan los siguientes archivos de clase y propiedad: <ul><li>MyResources.class <li>MyResources.properties <li>MyResources_fr.properties <li>MyResources_fr_CH.class <li MyResources_fr_CH.properties <li>>MyResources_en.properties <li>MyResources_es_ES.class </ul>
El contenido de todos los archivos es válido (es decir, subclases públicas no abstractas de ResourceBundle para los archivos ".class", sintácticamente correctos ".properties". La configuración regional predeterminada es Locale("en", "GB").
Al llamar getBundle a con los argumentos de configuración regional siguientes, se crearán instancias de los conjuntos de recursos de la siguiente manera:
<table class="striped"><caption style="display:none">getBundle() locale to resource bundle mapping</caption><thead><tr><th scope="col">Locale</th scope="col"Resource> bundle</th></tr/thead<>tbody><tr><>< th scope="row"Locale(">fr", "CH")</th><><td>MyResources_fr_CH.class, parent MyResources_fr.properties, parent MyResources.class</td></trtr th scope="row">Locale("fr", "FR")</th><td>MyResources_fr.properties, parent MyResources.class</td></tr tr><<>th scope="row">Locale("de", "DE")/th><td>MyResources_en.properties, parent MyResources.class/td/tr th scope="row"Locale(">en", "US")<</th><td>MyResources_en.properties, parent MyResources.class<</td><></tr<<>>><><><tr><th scope="row">Locale("es", "ES")</th><td>MyResources_es_ES.class, parent MyResources.class</td></tr></tbody></table>
El archivo MyResources_fr_CH.properties nunca se usa porque está oculto por la MyResources_fr_CH.class. Del mismo modo, MyResources.properties también está oculto por MyResources.class.
Agregado en la versión 1.2.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.
Se aplica a
GetBundle(String, Locale, ResourceBundle+Control)
Obtiene un conjunto de recursos mediante el nombre base especificado, la configuración regional predeterminada y el cargador de clases del autor de la llamada.
[Android.Runtime.Register("getBundle", "(Ljava/lang/String;Ljava/util/Locale;Ljava/util/ResourceBundle$Control;)Ljava/util/ResourceBundle;", "")]
public static Java.Util.ResourceBundle? GetBundle (string? baseName, Java.Util.Locale? targetLocale, Java.Util.ResourceBundle.Control? control);
[<Android.Runtime.Register("getBundle", "(Ljava/lang/String;Ljava/util/Locale;Ljava/util/ResourceBundle$Control;)Ljava/util/ResourceBundle;", "")>]
static member GetBundle : string * Java.Util.Locale * Java.Util.ResourceBundle.Control -> Java.Util.ResourceBundle
Parámetros
- baseName
- String
el nombre base del conjunto de recursos, un nombre de clase completo
- targetLocale
- Locale
configuración regional de destino del conjunto de recursos
- control
- ResourceBundle.Control
control que controla la secuencia de acceso
Devoluciones
un lote de recursos para el nombre base especificado y la configuración regional predeterminada
- Atributos
Comentarios
Documentación de Java para java.util.ResourceBundle.getBundle(java.lang.String).
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.
Se aplica a
GetBundle(String, Locale, ClassLoader, ResourceBundle+Control)
Obtiene un conjunto de recursos mediante el nombre base especificado, la configuración regional predeterminada y el cargador de clases del autor de la llamada.
[Android.Runtime.Register("getBundle", "(Ljava/lang/String;Ljava/util/Locale;Ljava/lang/ClassLoader;Ljava/util/ResourceBundle$Control;)Ljava/util/ResourceBundle;", "")]
public static Java.Util.ResourceBundle? GetBundle (string? baseName, Java.Util.Locale? targetLocale, Java.Lang.ClassLoader? loader, Java.Util.ResourceBundle.Control? control);
[<Android.Runtime.Register("getBundle", "(Ljava/lang/String;Ljava/util/Locale;Ljava/lang/ClassLoader;Ljava/util/ResourceBundle$Control;)Ljava/util/ResourceBundle;", "")>]
static member GetBundle : string * Java.Util.Locale * Java.Lang.ClassLoader * Java.Util.ResourceBundle.Control -> Java.Util.ResourceBundle
Parámetros
- baseName
- String
el nombre base del conjunto de recursos, un nombre de clase completo
- targetLocale
- Locale
configuración regional de destino del conjunto de recursos
- loader
- ClassLoader
el cargador de clases para cargar el recurso
- control
- ResourceBundle.Control
control que controla la secuencia de acceso
Devoluciones
un lote de recursos para el nombre base especificado y la configuración regional predeterminada
- Atributos
Comentarios
Documentación de Java para java.util.ResourceBundle.getBundle(java.lang.String).
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.