_Format Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Format
— это абстрактный базовый класс для форматирования конфиденциальной информации языкового стандарта, такой как даты, сообщения и числа.
[Android.Runtime.Register("java/text/Format", DoNotGenerateAcw=true)]
public abstract class _Format : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Lang.ICloneable
[<Android.Runtime.Register("java/text/Format", DoNotGenerateAcw=true)>]
type _Format = class
inherit Object
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface ICloneable
- Наследование
- Производный
- Атрибуты
- Реализации
Комментарии
Format
— это абстрактный базовый класс для форматирования конфиденциальной информации языкового стандарта, такой как даты, сообщения и числа.
Format
определяет программный интерфейс для форматирования объектов, чувствительных к языковому стандарту, в String
s ( format
метод) и для анализа String
обратно в объекты ( parseObject
метод ).
Как правило, метод формата parseObject
должен иметь возможность анализировать любую строку, отформатированную методом format
. Однако могут быть исключительные случаи, когда это невозможно. Например, format
метод может создать два смежных целочисленных числа без разделителя между, и в этом случае parseObject
не может определить, какие цифры принадлежат к какому числу.
<h2>Подклассы</h2>
Платформа Java предоставляет три специализированных подкласса Format
-- DateFormat
, MessageFormat
и NumberFormat
--для форматирования дат, сообщений и чисел соответственно.
Конкретные подклассы должны реализовывать три метода: <ol><li>format(Object obj, StringBuffer toAppendTo, FieldPosition pos)
<li>formatToCharacterIterator(Object obj)
<li liparseObject(String source, ParsePosition pos)
<>/ol>. Эти общие методы позволяют полиморфный анализ и форматирование объектов и используются, например, .MessageFormat
Подклассы часто также предоставляют дополнительные format
методы для определенных типов входных данных, а также parse
методы для конкретных типов результатов. Любой parse
метод, который не принимает ParsePosition
аргумент, должен вызывать исключение ParseException
, если текст в требуемом формате не находится в начале входного текста.
Большинство подклассов также реализуют следующие методы фабрики: <ol><li>getInstance
для получения полезного объекта форматирования, соответствующего текущему языковому стандарту <li>getInstance(Locale)
, для получения полезного объекта форматирования, соответствующего указанному языковому стандарту </ol> . Кроме того, некоторые подклассы могут также реализовывать другие getXxxxInstance
методы для более специализированного элемента управления. Например, NumberFormat
класс предоставляет getPercentInstance
методы и getCurrencyInstance
для получения специализированных числовых форматировщиков.
Подклассы Format
класса , которые позволяют программистам создавать объекты для языковых стандартов (например, с getInstance(Locale)
), также должны реализовывать следующий метод класса: <blockquote>
public static Locale[] getAvailableLocales()
</blockquote>
И, наконец, подклассы могут определять набор констант для идентификации различных полей в форматированных выходных данных. Эти константы используются для создания объекта FieldPosition, который определяет, какие сведения содержатся в поле и его положение в отформатированных результатах. Эти константы должны называться <em>item</em>_FIELD
там, где <em>item</em>
идентифицирует поле. Примеры этих констант см ERA_FIELD
. в разделе и их друзей в DateFormat
.
<h3>"synchronization">Synchronization</h3>
Форматы обычно не синхронизируются. Рекомендуется создать отдельные экземпляры формата для каждого потока. Если несколько потоков обращаются к формату одновременно, он должен быть синхронизирован извне.
Добавлено в версии 1.1.
Документация по Java для java.text.Format
.
Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License Creative Commons 2.5 Attribution License.
Конструкторы
_Format() |
Конструктор Sole. |
_Format(IntPtr, JniHandleOwnership) |
Конструктор, используемый при создании управляемых представлений объектов JNI; вызывается средой выполнения. |
Свойства
Class |
Возвращает класс среды выполнения данного объекта |
Handle |
Дескриптор базового экземпляра Android. (Унаследовано от Object) |
JniIdentityHashCode |
|
JniPeerMembers |
|
PeerReference |
|
ThresholdClass |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. |
ThresholdType |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. |
Методы
Clone() |
Создает и возвращает копию этого объекта. |
Dispose() |
|
Dispose(Boolean) |
|
Equals(Object) |
Указывает, равен ли какой-то другой объект этому объекту. (Унаследовано от Object) |
Format(Object) |
Форматирует объект для создания строки. |
Format(Object, StringBuffer, FieldPosition) |
Форматирует объект и добавляет результирующий текст в заданный строковый буфер. |
FormatToCharacterIterator(Object) |
Форматирует объект , создающий |
GetHashCode() |
Возвращает значение хэш-кода для объекта. (Унаследовано от Object) |
JavaFinalize() |
Вызывается сборщиком мусора для объекта , когда сборка мусора определяет, что больше нет ссылок на объект . (Унаследовано от Object) |
Notify() |
Пробуждение одного потока, ожидающего на мониторе этого объекта. (Унаследовано от Object) |
NotifyAll() |
Активирует все потоки, ожидающие на мониторе этого объекта. (Унаследовано от Object) |
ParseObject(String) |
Анализирует текст от начала заданной строки для создания объекта . |
ParseObject(String, ParsePosition) |
Анализирует текст из строки для создания объекта . |
SetHandle(IntPtr, JniHandleOwnership) |
Задает свойство Handle. (Унаследовано от Object) |
ToArray<T>() |
|
ToString() |
Возвращает строковое представление объекта. (Унаследовано от Object) |
UnregisterFromRuntime() |
|
Wait() |
Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления/><em> или <прерывания></em>. (Унаследовано от Object) |
Wait(Int64) |
Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> em, либо до истечения определенного количества реального времени. (Унаследовано от Object) |
Wait(Int64, Int32) |
Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> em, либо до истечения определенного количества реального времени. (Унаследовано от 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) |
|