Properties Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Класс Properties
представляет постоянный набор свойств.
[Android.Runtime.Register("java/util/Properties", DoNotGenerateAcw=true)]
public class Properties : Java.Lang.Object
[<Android.Runtime.Register("java/util/Properties", DoNotGenerateAcw=true)>]
type Properties = class
inherit Object
- Наследование
- Производный
- Атрибуты
Комментарии
Класс Properties
представляет постоянный набор свойств. Можно Properties
сохранить в поток или загрузить из потока. Каждый ключ и соответствующее ему значение в списке свойств является строкой.
Список свойств может содержать другой список свойств в качестве его "по умолчанию"; Этот второй список свойств выполняется, если ключ свойства не найден в исходном списке свойств.
Так как Properties
наследуется от Hashtable
, put
методы и putAll
могут применяться к объекту Properties
. Их использование настоятельно не рекомендуется, так как они позволяют вызывающему объекту вставлять записи, ключи или значения которых не Strings
являются . Вместо setProperty
этого следует использовать метод . store
Если метод или save
вызывается для "скомпрометированного" Properties
объекта, содержащего неString
ключ или значение, вызов завершится ошибкой. Аналогичным образом вызов метода или завершится ошибкойpropertyNames
, если он вызывается для "скомпрометированного" Properties
объекта, содержащего неключийString
.list
Методы #load(java.io.Reader) load(Reader)
/
#store(java.io.Writer, java.lang.String) store(Writer, String)
загружают и сохраняют свойства из и в символьный поток в простом строковом формате, указанном ниже.
Методы #load(java.io.InputStream) load(InputStream)
/
#store(java.io.OutputStream, java.lang.String) store(OutputStream, String)
работают так же, как и пара load(Reader)/store(Writer, String), за исключением того, что поток ввода-вывода закодирован в кодировке ISO 8859-1. Символы, которые не могут быть представлены напрямую в этой кодировке, могут быть записаны с помощью escape-символов Юникода, как определено в разделе 3.3 статьи <Цитирование>Java&торговли; Language Specification</cite>; в escape-последовательности допускается только один символ u. Средство native2ascii можно использовать для преобразования файлов свойств в другие кодировки символов и из нее.
Методы #loadFromXML(InputStream)
и #storeToXML(OutputStream, String, String)
загружают и сохраняют свойства в простом формате XML. По умолчанию используется кодировка символов UTF-8, однако при необходимости может быть указана определенная кодировка. Реализации необходимы для поддержки UTF-8 и UTF-16 и могут поддерживать другие кодировки. Xml-документ свойств содержит следующее объявление DOCTYPE:
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
Обратите внимание, что системный URI (http://java.sun.com/dtd/properties.dtd)не используется при экспорте или импорте свойств; он просто служит строкой для уникальной идентификации DTD, то есть:
<?xml version="1.0" encoding="UTF-8"?>
<!-- DTD for properties -->
<!ELEMENT properties ( comment?, entry* ) >
<!ATTLIST properties version CDATA #FIXED "1.0">
<!ELEMENT comment (#PCDATA) >
<!ELEMENT entry (#PCDATA) >
<!ATTLIST entry key CDATA #REQUIRED>
Этот класс является потокобезопасно: несколько потоков могут совместно использовать один Properties
объект без необходимости внешней синхронизации.
Добавлено в JDK1.0.
Документация по Java для java.util.Properties
.
Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом Android и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License.
Конструкторы
Properties() |
Создает пустой список свойств без значений по умолчанию. |
Properties(IntPtr, JniHandleOwnership) |
Конструктор, используемый при создании управляемых представлений объектов JNI; вызывается средой выполнения. |
Properties(Properties) |
Создает пустой список свойств с заданными значениями по умолчанию. |
Свойства
Class |
Возвращает класс среды выполнения данного объекта |
Defaults |
Список свойств, содержащий значения по умолчанию для всех ключей, не найденных в этом списке свойств. |
Handle |
Дескриптор базового экземпляра Android. (Унаследовано от Object) |
JniIdentityHashCode |
Класс |
JniPeerMembers |
Класс |
PeerReference |
Класс |
ThresholdClass |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. |
ThresholdType |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. |
Методы
Clone() |
Создает и возвращает копию этого объекта. (Унаследовано от Object) |
Dispose() |
Класс |
Dispose(Boolean) |
Класс |
Equals(Object) |
Указывает, равен ли какой-то другой объект этому объекту. (Унаследовано от Object) |
GetHashCode() |
Возвращает значение хэш-кода для объекта. (Унаследовано от Object) |
GetProperty(String) |
Выполняет поиск свойства с указанным ключом в этом списке свойств. |
GetProperty(String, String) |
Выполняет поиск свойства с указанным ключом в этом списке свойств. |
JavaFinalize() |
Вызывается сборщиком мусора для объекта , когда сборка мусора определяет, что больше нет ссылок на объект . (Унаследовано от Object) |
List(PrintStream) |
Выводит этот список свойств в указанный выходной поток. |
List(PrintWriter) |
Выводит этот список свойств в указанный выходной поток. |
Load(Reader) |
Считывает список свойств (пары ключей и элементов) из входного символьного потока в простом формате, ориентированном на линии. |
Load(Stream) |
Считывает список свойств (пары ключей и элементов) из входного потока байтов. |
LoadFromXML(Stream) |
Загружает все свойства, представленные XML-документом в указанном входном потоке, в эту таблицу свойств. |
Notify() |
Пробуждает один поток, ожидающий монитора этого объекта. (Унаследовано от Object) |
NotifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. (Унаследовано от Object) |
PropertyNames() |
Возвращает перечисление всех ключей в этом списке свойств, включая отдельные ключи в списке свойств по умолчанию, если ключ с таким же именем еще не найден из списка свойств main. |
Save(Stream, String) |
Устаревшие..
|
SetHandle(IntPtr, JniHandleOwnership) |
Задает свойство Handle. (Унаследовано от Object) |
SetProperty(String, String) |
|
Store(Stream, String) |
Записывает этот список свойств (пары ключей и элементов) в этой |
Store(Writer, String) |
Записывает этот список свойств (пары ключей и элементов) в этой |
StoreToXML(Stream, String) |
Создает XML-документ, представляющий все свойства, содержащиеся в этой таблице. |
StoreToXML(Stream, String, String) |
Выдает XML-документ, представляющий все свойства, содержащиеся в этой таблице, используя указанную кодировку. |
StringPropertyNames() |
Возвращает набор ключей в этом списке свойств, где ключ и соответствующее ему значение являются строками, включая отдельные ключи в списке свойств по умолчанию, если ключ с таким же именем еще не найден из списка свойств main. |
ToArray<T>() |
Класс |
ToString() |
Возвращает строковое представление объекта. (Унаследовано от Object) |
UnregisterFromRuntime() |
Класс |
Wait() |
Вызывает ожидание текущего потока, пока он не пробудится, как правило, из-за <уведомления><<> или>прерывания или прерывания.>< (Унаследовано от Object) |
Wait(Int64) |
Вызывает ожидание текущего потока, пока он не пробудится, как правило, путем <уведомления><<> или>прерывания или прерывания<> или до истечения определенного количества реального времени. (Унаследовано от Object) |
Wait(Int64, Int32) |
Вызывает ожидание текущего потока, пока он не пробудится, как правило, путем <уведомления><<> или>прерывания или прерывания<> или до истечения определенного количества реального времени. (Унаследовано от Object) |
Явные реализации интерфейса
IJavaPeerable.Disposed() |
Класс |
IJavaPeerable.DisposeUnlessReferenced() |
Класс |
IJavaPeerable.Finalized() |
Класс |
IJavaPeerable.JniManagedPeerState |
Класс |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
Класс |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Класс |
IJavaPeerable.SetPeerReference(JniObjectReference) |
Класс |
Методы расширения
JavaCast<TResult>(IJavaObject) |
Выполняет преобразование типа, проверенного средой выполнения Android. |
JavaCast<TResult>(IJavaObject) |
Класс |
GetJniTypeName(IJavaPeerable) |
Класс |