Properties.Load Método

[Android.Runtime.Register("load", "(Ljava/io/Reader;)V", "GetLoad_Ljava_io_Reader_Handler")]
public virtual void Load(Java.IO.Reader? reader);

[<Android.Runtime.Register("load", "(Ljava/io/Reader;)V", "GetLoad_Ljava_io_Reader_Handler")>]
abstract member Load : Java.IO.Reader -> unit
override this.Load : Java.IO.Reader -> unit

Parâmetros

Atributos

RegisterAttribute

Exceções

Comentários

Lê uma lista de propriedades (pares de chave e elemento) do fluxo de caracteres de entrada em um formato simples orientado a linhas.

As propriedades são processadas em termos de linhas. Há dois tipos de linha, linhas naturais e linhas lógicas. Uma linha natural é definida como uma linha de caracteres que é encerrada por um conjunto de caracteres do terminador de linha (\n ou \r ou \r\n) ou pelo final do fluxo. Uma linha natural pode ser uma linha em branco, uma linha de comentário ou manter todos ou alguns de um par de elementos-chave. Uma linha lógica contém todos os dados de um par chave-elemento, que pode ser espalhado por várias linhas naturais adjacentes, escapando da sequência do terminador de linha com um caractere de barra invertida \. Observe que uma linha de comentário não pode ser estendida dessa maneira; cada linha natural que é um comentário deve ter seu próprio indicador de comentário, conforme descrito abaixo. As linhas são lidas da entrada até que o final do fluxo seja atingido.

Uma linha natural que contém apenas caracteres de espaço em branco é considerada em branco e ignorada. Uma linha de comentário tem uma ASCII '#' ou '!' como seu primeiro caractere de espaço não branco; as linhas de comentário também são ignoradas e não codificam informações de elemento-chave. Além dos terminadores de linha, esse formato considera o espaço de caracteres (' ', '\u005Cu0020'), a guia ('\t', '\u005Cu0009') e o feed de formulário ('\f', '\u005Cu000C') como espaço em branco.

Se uma linha lógica for distribuída entre várias linhas naturais, a barra invertida que escapa da sequência do terminador de linha, a sequência do terminador de linha e qualquer espaço em branco no início da linha a seguir não afetará os valores de chave ou elemento. O restante da discussão sobre a análise de elementos e chave (ao carregar) assumirá que todos os caracteres que constituem a chave e o elemento aparecem em uma única linha natural após a remoção dos caracteres de continuação de linha. Observe que não é suficiente examinar apenas o caractere que precede uma sequência de terminador de linha para decidir se o terminador de linha é escapado; deve haver um número ímpar de barras invertidas contíguas para que o terminador de linha seja escapado. Como a entrada é processada da esquerda para a direita, um número par diferente de zero de 2n barras invertidas contíguas antes que um terminador de linha (ou em outro lugar) codifica n barras invertidas após o processamento de escape.

A chave contém todos os caracteres na linha começando com o primeiro caractere de espaço não branco e até, mas não incluindo, o primeiro caractere sem escape '=', ':'ou espaço em branco diferente de um terminador de linha. Todos esses caracteres de terminação de chave podem ser incluídos na chave por meio do escape deles com um caractere de barra invertida anterior; por exemplo,

\:\=

seria a chave de dois caracteres ":=". Os caracteres do terminador de linha podem ser incluídos usando \r e \n fugindo de sequências. Qualquer espaço em branco após a chave ser ignorada; se o primeiro caractere de espaço não branco após a chave for '=' ou ':', em seguida, ele for ignorado e quaisquer caracteres de espaço em branco depois que ele também for ignorado. Todos os caracteres restantes na linha tornam-se parte da cadeia de caracteres do elemento associado; se não houver nenhum caractere restante, o elemento será a cadeia de caracteres ""vazia. Depois que as sequências de caracteres brutos que constituem a chave e o elemento forem identificadas, o processamento de escape será executado conforme descrito acima.

Por exemplo, cada uma das três linhas a seguir especifica a chave "Truth" e o valor "Beauty"do elemento associado:

Truth = Beauty
             Truth:Beauty
            Truth                    :Beauty

Como outro exemplo, as três linhas a seguir especificam uma única propriedade:

fruits                           apple, banana, pear, \
                                             cantaloupe, watermelon, \
                                             kiwi, mango

A chave é "fruits" e o elemento associado é:

"apple, banana, pear, cantaloupe, watermelon, kiwi, mango"

Observe que um espaço aparece antes de cada \ um para que um espaço apareça após cada vírgula no resultado final; o \terminador de linha e o espaço em branco à esquerda na linha de continuação são meramente descartados e não são substituídos por um ou mais outros caracteres.

Como um terceiro exemplo, a linha:

cheeses

especifica que a chave é "cheeses" e o elemento associado é a cadeia de caracteres ""vazia.

"unicodeescapes" Caracteres em chaves e elementos podem ser representados em sequências de escape semelhantes às usadas para literais de caracteres e cadeias de caracteres (consulte as seções 3.3 e 3.10.6 do citeThe Java& trade; Especificação/citação da linguagem).

As diferenças em relação às sequências de escape de caracteres e escapes Unicode usadas para caracteres e cadeias de caracteres são:

<As fugas de ul><li> Octal não são reconhecidas.

<li> A sequência \b de caracteres não representa um caractere de backspace.

<li> O método não trata um caractere de barra invertida, \antes de um caractere de escape não válido como um erro; a barra invertida é descartada silenciosamente. Por exemplo, em uma cadeia de caracteres Java, a sequência "\z" causaria um erro de tempo de compilação. Por outro lado, esse método descarta silenciosamente a barra invertida. Portanto, esse método trata a sequência "\b" de dois caracteres como equivalente ao caractere 'b'único.

< > Li Escapes não são necessários para aspas simples e duplas; no entanto, pela regra acima, caracteres de aspas simples e duplas precedidos por uma barra invertida ainda produzem caracteres de aspas simples e duplas, respectivamente.

<li> Somente um único caractere 'u' é permitido em uma sequência de escape Unicode.

</ul>

O fluxo especificado permanece aberto após o retorno desse método.

Adicionado em 1.6.

Java documentação para java.util.Properties.load(java.io.Reader).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

[Android.Runtime.Register("load", "(Ljava/io/InputStream;)V", "GetLoad_Ljava_io_InputStream_Handler")]
public virtual void Load(System.IO.Stream? inStream);

[<Android.Runtime.Register("load", "(Ljava/io/InputStream;)V", "GetLoad_Ljava_io_InputStream_Handler")>]
abstract member Load : System.IO.Stream -> unit
override this.Load : System.IO.Stream -> unit

Parâmetros

Atributos

RegisterAttribute

Exceções

Comentários

Lê uma lista de propriedades (pares de chave e elemento) do fluxo de bytes de entrada. O fluxo de entrada está em um formato simples orientado a linhas, conforme especificado #load(java.io.Reader) load(Reader) e supõe-se que use a codificação de caracteres ISO 8859-1; ou seja, cada byte é um caractere Latino1. Caracteres não em latim1 e determinados caracteres especiais são representados em chaves e elementos usando escapes Unicode, conforme definido na seção 3.3 do citeThe Java& trade; Especificação/citação da linguagem.

O fluxo especificado permanece aberto após o retorno desse método.

Adicionado em 1.2.

Java documentação para java.util.Properties.load(java.io.InputStream).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.