ResourceBundle.GetBundle Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| GetBundle(String) |
Obtém um pacote de recursos usando o nome base especificado, a localidade padrão e o carregador de classes do chamador. |
| GetBundle(String, Locale) |
Obtém um pacote de recursos usando o nome base e a localidade especificados e o carregador de classes do chamador. |
| GetBundle(String, ResourceBundle+Control) |
Obtém um pacote de recursos usando o nome base especificado, a localidade padrão e o carregador de classes do chamador. |
| GetBundle(String, Locale, ClassLoader) |
Obtém um pacote de recursos usando o nome base, a localidade e o carregador de classes especificados. |
| GetBundle(String, Locale, ResourceBundle+Control) |
Obtém um pacote de recursos usando o nome base especificado, a localidade padrão e o carregador de classes do chamador. |
| GetBundle(String, Locale, ClassLoader, ResourceBundle+Control) |
Obtém um pacote de recursos usando o nome base especificado, a localidade padrão e o carregador de classes do chamador. |
GetBundle(String)
Obtém um pacote de recursos usando o nome base especificado, a localidade padrão e o carregador de classes do chamador.
[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.ResourceBundleParâmetros
- baseName
- String
o nome base do pacote de recursos, um nome de classe totalmente qualificado
Retornos
um pacote de recursos para o nome base fornecido e a localidade padrão
- Atributos
Exceções
se o ResourceBundle não puder ser encontrado.
Comentários
Obtém um pacote de recursos usando o nome base especificado, a localidade padrão e o carregador de classes do chamador. Chamar esse método é equivalente a chamar <blockquote>getBundle(baseName, Locale.getDefault(), this.getClass().getClassLoader()), </blockquote>
Documentação Java para java.util.ResourceBundle.getBundle(java.lang.String).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.
Aplica-se a
GetBundle(String, Locale)
Obtém um pacote de recursos usando o nome base e a localidade especificados e o carregador de classes do chamador.
[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.ResourceBundleParâmetros
- baseName
- String
o nome base do pacote de recursos, um nome de classe totalmente qualificado
- locale
- Locale
A localidade para a qual um pacote de recursos é desejado
Retornos
um pacote de recursos para o nome base e a localidade fornecidos
- Atributos
Exceções
se o pacote de recursos não puder ser encontrado.
Comentários
Obtém um pacote de recursos usando o nome base e a localidade especificados e o carregador de classes do chamador. Chamar esse método é equivalente a chamar <blockquote>getBundle(baseName, locale, this.getClass().getClassLoader()), </blockquote>
Documentação Java para java.util.ResourceBundle.getBundle(java.lang.String, java.util.Locale).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.
Aplica-se a
GetBundle(String, ResourceBundle+Control)
Obtém um pacote de recursos usando o nome base especificado, a localidade padrão e o carregador de classes do chamador.
[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.ResourceBundleParâmetros
- baseName
- String
o nome base do pacote de recursos, um nome de classe totalmente qualificado
- control
- ResourceBundle.Control
O controle que controla a sequência de acesso
Retornos
um pacote de recursos para o nome base fornecido e a localidade padrão
- Atributos
Comentários
Documentação Java para java.util.ResourceBundle.getBundle(java.lang.String).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.
Aplica-se a
GetBundle(String, Locale, ClassLoader)
Obtém um pacote de recursos usando o nome base, a localidade e o carregador de classes 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.ResourceBundleParâmetros
- baseName
- String
o nome base do pacote de recursos, um nome de classe totalmente qualificado
- locale
- Locale
A localidade para a qual um pacote de recursos é desejado
- loader
- ClassLoader
O carregador de classes a partir do qual carregar o pacote de recursos
Retornos
um pacote de recursos para o nome base e a localidade fornecidos
- Atributos
Exceções
se o ResourceBundle não puder ser encontrado.
Comentários
Obtém um pacote de recursos usando o nome base, a localidade e o carregador de classes especificados.
Isso equivale a chamar: <blockquote>
getBundle(baseName, targetLocale, loader, control)
</blockquote> passando uma instância padrão de Control. Consulte a descrição da modificação do comportamento padrão. O seguinte descreve o comportamento padrão.
<b>"default_behavior">Estratégia de Pesquisa e Carregamento de Pacotes de Recursos</b>
getBundle usa o nome base, a localidade especificada e a localidade padrão (obtida de java.util.Locale#getDefault() Locale.getDefault) para gerar uma sequência de "candidates"><em>candidate bundle names</em>. Se o idioma, o script, o país e a variante da localidade especificada forem cadeias de caracteres vazias, o nome base será o único nome do pacote candidato. Caso contrário, uma lista de localidades candidatas é gerada a partir dos valores de atributo da localidade especificada (idioma, script, país e variante) e anexada ao nome base. Normalmente, isso terá a seguinte aparência:
baseName + "_" + language + "_" + script + "_" + country + "_" + variant
baseName + "_" + language + "_" + script + "_" + country
baseName + "_" + language + "_" + script
baseName + "_" + language + "_" + country + "_" + variant
baseName + "_" + language + "_" + country
baseName + "_" + language
Os nomes dos pacotes de candidatos em que o componente final é uma cadeia de caracteres vazia são omitidos, juntamente com o sublinhado. Por exemplo, se country for uma cadeia de caracteres vazia, os nomes do segundo e do quinto pacote de candidatos acima serão omitidos. Além disso, se script for uma cadeia de caracteres vazia, os nomes de candidatos, incluindo script, serão omitidos. Por exemplo, uma localidade com o idioma "de" e a variante "JAVA" produzirá nomes candidatos com o nome base "MyResource" abaixo.
MyResource_de__JAVA
MyResource_de
No caso de a variante conter um ou mais sublinhados ('_'), uma sequência de nomes de pacotes gerada pelo truncamento do último sublinhado e da parte seguinte é inserida após um nome de pacote candidato com a variante original. Por exemplo, para uma localidade com idioma "en", script "Latn, país "US" e variante "WINDOWS_VISTA" e nome base do pacote "MyResource", a lista de nomes de pacotes candidatos abaixo é gerada:
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>Nota:</b> Para alguns Locales, a lista de nomes de pacotes candidatos contém nomes extras, ou a ordem dos nomes de pacotes é ligeiramente modificada. Consulte a descrição da implementação padrão de Control#getCandidateLocales(String, Locale) getCandidateLocales para obter detalhes.</blockquote>
getBundleem seguida, itera sobre os nomes do pacote candidato para encontrar o primeiro para o qual ele pode <instanciar></em> um pacote de recursos real. Ele usa o método de controles padrão, que gera dois nomes de Control#getFormats getFormats pacote para cada nome gerado, o primeiro um nome de classe e o segundo um nome de arquivo de propriedades. Para cada nome de pacote candidato, ele tenta criar um pacote de recursos:
<><ul li>Primeiro, ele tenta carregar uma classe usando o nome da classe gerada. Se essa classe puder ser encontrada e carregada usando o carregador de classes especificado, for a atribuição compatível com ResourceBundle, for acessível a partir de ResourceBundle e puder ser instanciada, getBundle criará uma nova instância dessa classe e a usará como o <pacote< de recursos de resultado em>/em>.
<li>Caso contrário, getBundle tentará localizar um arquivo de recurso de propriedade usando o nome do arquivo de propriedades gerado. Ele gera um nome de caminho a partir do nome do pacote candidato substituindo todos os caracteres "." por "/" e anexando a cadeia de caracteres ".properties". Ele tenta encontrar um "recurso" com esse nome usando java.lang.ClassLoader#getResource(java.lang.String) ClassLoader.getResource. (Observe que um "recurso" no sentido de getResource não tem nada a ver com o conteúdo de um pacote de recursos, é apenas um contêiner de dados, como um arquivo.) Se ele encontrar um "recurso", ele tentará criar uma nova PropertyResourceBundle instância a partir de seu conteúdo. Se for bem-sucedida, essa instância se tornará o <pacote< de recursos de resultado em>/em>. </ul>
Isso continua até que um pacote de recursos de resultado seja instanciado ou a lista de nomes de pacotes candidatos seja esgotada. Se nenhum pacote de recursos correspondente for encontrado, o método do Control#getFallbackLocale getFallbackLocale controle padrão será chamado, o que retornará a localidade padrão atual. Uma nova sequência de nomes de localidade candidatos é gerada usando essa localidade e pesquisada novamente, como acima.
Se ainda assim nenhum pacote de resultados for encontrado, somente o nome base será pesquisado. Se isso ainda falhar, um MissingResourceException é lançado.
"parent_chain"> Depois que um pacote de recursos de resultado for encontrado, sua <cadeia< pai em>/em> será instanciada. Se o pacote de resultados já tiver um pai (talvez porque ele foi retornado de um cache), a cadeia estará concluída.
Caso contrário, getBundle examinará o restante da lista de localidade candidata que foi usada durante a passagem que gerou o pacote de recursos de resultado. (Como antes, os nomes de pacotes de candidatos em que o componente final é uma cadeia de caracteres vazia são omitidos.) Quando se trata do final da lista de candidatos, ele tenta o nome do pacote simples. Com cada um dos nomes de pacote candidato, ele tenta instanciar um pacote de recursos (primeiro procurando uma classe e, em seguida, um arquivo de propriedades, conforme descrito acima).
Sempre que for bem-sucedido, ele chama o método do pacote de #setParent(java.util.ResourceBundle) setParent recursos instanciado anteriormente com o novo pacote de recursos. Isso continua até que a lista de nomes seja esgotada ou o pacote atual já tenha um pai não nulo.
Quando a cadeia pai estiver concluída, o pacote será retornado.
<b>Nota:</b>getBundle armazena em cache pacotes de recursos instanciados e pode retornar a mesma instância do pacote de recursos várias vezes.
<b>Nota:</b>O baseName argumento deve ser um nome de classe totalmente qualificado. No entanto, para compatibilidade com versões anteriores, Java SE Runtime Environments não verificam isso e, portanto, é possível acessar PropertyResourceBundles especificando um nome de caminho (usando "/") em vez de um nome de classe totalmente qualificado (usando ".").
"default_behavior_example"><strong>Exemplo:</strong>
Os seguintes arquivos de classe e propriedade são fornecidos: <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>
O conteúdo de todos os arquivos são válidos (ou seja, subclasses públicas não abstratas de ResourceBundle para os arquivos ".class", arquivos ".properties" sintaticamente corretos). A localidade padrão é Locale("en", "GB").
Chamar getBundle com os argumentos de localidade abaixo instanciará os pacotes de recursos da seguinte maneira:
<table class="striped"><caption style="display:none">getBundle() locale to resource bundle mapping</caption><thead<>tr><th scope="col"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></tr><><tr 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<>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, pai MyResources.class</td></tr></tbody></table>
O arquivo MyResources_fr_CH.properties nunca é usado porque está oculto pelo MyResources_fr_CH.class. Da mesma forma, MyResources.properties também está oculto por MyResources.class.
Adicionado em 1.2.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.
Aplica-se a
GetBundle(String, Locale, ResourceBundle+Control)
Obtém um pacote de recursos usando o nome base especificado, a localidade padrão e o carregador de classes do chamador.
[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.ResourceBundleParâmetros
- baseName
- String
o nome base do pacote de recursos, um nome de classe totalmente qualificado
- targetLocale
- Locale
A localidade de destino do pacote de recursos
- control
- ResourceBundle.Control
O controle que controla a sequência de acesso
Retornos
um pacote de recursos para o nome base fornecido e a localidade padrão
- Atributos
Comentários
Documentação Java para java.util.ResourceBundle.getBundle(java.lang.String).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.
Aplica-se a
GetBundle(String, Locale, ClassLoader, ResourceBundle+Control)
Obtém um pacote de recursos usando o nome base especificado, a localidade padrão e o carregador de classes do chamador.
[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.ResourceBundleParâmetros
- baseName
- String
o nome base do pacote de recursos, um nome de classe totalmente qualificado
- targetLocale
- Locale
A localidade de destino do pacote de recursos
- loader
- ClassLoader
O carregador de classes para carregar o recurso
- control
- ResourceBundle.Control
O controle que controla a sequência de acesso
Retornos
um pacote de recursos para o nome base fornecido e a localidade padrão
- Atributos
Comentários
Documentação Java para java.util.ResourceBundle.getBundle(java.lang.String).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.