Объектно-ориентированное программирование.-6
.pdfдля инвариантной культуры обозначается символом U+2030 (‰).
Табл. Г.2 – Основные члены класса System.Globalization.DateTimeFormatInfo
Член |
|
|
Описание |
|
||
|
|
|
|
|
|
|
Конструкторы |
|
|
|
|
||
|
|
|
|
|||
DateTimeFormatInfo() |
|
Инициализирует |
новый |
экзем- |
||
|
|
пляр класса DateTimeFormatInfo, |
||||
|
|
не зависящий от языка и регио- |
||||
|
|
нальных параметров (инвариант- |
||||
|
|
ный) |
|
|
|
|
|
|
|
|
|
|
|
Методы |
|
|
|
|
|
|
|
|
|||||
string |
|
Возвращает полное название ука- |
||||
GetAbbreviatedDayName(DayOfWeek |
|
занного дня недели, принятое в |
||||
|
|
|||||
dayofweek) |
|
определенном языке и регио- |
||||
|
|
|||||
|
|
нальных параметрах |
|
|
||
|
|
|
|
|||
string GetAbbreviatedEraName(int |
|
Возвращает строку, |
содержащую |
|||
era) |
|
сокращенное название указанной |
||||
|
|
|||||
|
|
эры |
|
|
|
|
|
|
|
|
|
||
string GetAbbreviatedMonthName(int |
|
Возвращает |
сокращение |
указан- |
||
month) |
|
ного месяца, принятое в опреде- |
||||
|
|
|||||
|
|
ленном языке и |
региональных |
|||
|
|
параметрах |
|
|
|
|
|
|
|
|
|
|
|
string[] GetAllDateTimePatterns() |
|
Возвращает |
все |
|
стандартные |
|
|
|
шаблоны, в которых можно фор- |
||||
|
|
матировать значения DateTime |
||||
|
|
|
|
|
|
|
string[] |
|
Возвращает |
все |
|
стандартные |
|
GetAllDateTimePatterns(char format) |
|
шаблоны, в которых можно фор- |
||||
|
|
матировать значения DateTime с |
||||
|
|
помощью |
указанного |
шаблона |
||
|
|
формата |
|
|
|
|
|
|
|
|
|
||
string GetDayName(DayOfWeek |
|
Возвращает |
сокращение |
указан- |
||
dayofweek) |
|
ного дня недели, принятое в |
||||
|
|
|||||
|
|
определенном языке и регио- |
||||
|
|
нальных параметрах |
|
|
||
|
|
|
|
|
||
int GetEra(string eraName) |
|
Возвращает |
целое |
число, пред- |
||
|
|
|
|
|
|
|
461 |
|
|
|
|
|
|
|
|
ставляющее собой указанную эру |
|
|
|
string GetEraName(int era) |
|
Возвращает строку, содержащую |
|
|
название указанной эры |
|
|
|
string GetMonthName(int month) |
|
Возвращает полное имя указан- |
|
|
ного месяца, принятое в опреде- |
|
|
ленном языке и региональных |
|
|
параметрах |
|
|
|
string GetShortestDayName(DayOfWeek |
|
Получает самое короткое сокра- |
dayOfWeek) |
|
щенное название дня для опреде- |
|
|
|
|
|
ленного дня недели |
|
|
|
void |
|
Устанавливает стандартные шаб- |
SetAllDateTimePatterns(string[] |
|
лоны, в которых можно форма- |
patterns, char format) |
|
|
|
тировать значения DateTime |
|
|
|
|
|
|
|
Свойства |
|
|
|
|
|
string[] AbbreviatedDayNames |
|
Сокращения дней недели, приня- |
|
|
тые в определенном языке и ре- |
|
|
гиональных параметрах |
|
|
|
string[] AbbreviatedMonthNames |
|
Сокращения месяцев, принятые в |
|
|
определенном языке и регио- |
|
|
нальных параметрах |
|
|
|
string AMDesignator |
|
Строка указателя часов до полу- |
|
|
дня (АМ – ante meridiem) |
|
|
|
string DateSeparator |
|
Строка, разделяющая компонен- |
|
|
ты даты – год, месяц и день |
|
|
|
string[] DayNames |
|
Полные названия дней недели, |
|
|
принятые в определенном языке |
|
|
и региональных параметрах |
|
|
|
DayOfWeek FirstDayOfWeek |
|
Первый день недели |
|
|
|
string FullDateTimePattern |
|
Шаблон формата для длинного |
|
|
формата даты и длинного форма- |
|
|
та времени, связанный с шабло- |
|
|
ном формата «F» |
|
|
|
string LongDatePattern |
|
Шаблон формата для длинного |
|
|
формата даты и длинного форма- |
|
|
та времени, связанный с шабло- |
|
|
|
462 |
|
|
|
|
ном формата «D» |
|
|
|
string LongTimePattern |
|
Шаблон формата для длинного |
|
|
формата времени, связанного с |
|
|
шаблоном формата «T» |
|
|
|
string MonthDayPattern |
|
Шаблон формата для значения |
|
|
месяца и дня, связанный с шаб- |
|
|
лонами формата «m» и «M» |
|
|
|
string[] MonthNames |
|
Полные названия месяцев, при- |
|
|
нятые в определенном языке и |
|
|
региональных параметрах |
|
|
|
string PMDesignator |
|
Строка указателя часов после по- |
|
|
лудня (PМ – post meridiem) |
|
|
|
string RFC1123Pattern |
|
Шаблон формата для значения |
|
|
времени на основе спецификации |
|
|
1123 RFC IETF, связанный с |
|
|
шаблонами формата «r» и «R» |
|
|
|
string ShortDatePattern |
|
Шаблон формата для краткого |
|
|
формата даты, связанный с шаб- |
|
|
лоном формата «d» |
|
|
|
string[] ShortestDayNames |
|
Самые краткие уникальные со- |
|
|
кращения имен дней |
|
|
|
string ShortTimePattern |
|
Шаблон формата для краткого |
|
|
формата времени, связанного с |
|
|
шаблоном формата «t» |
|
|
|
string SortableDateTimePattern |
|
Шаблон формата для значения |
|
|
даты и времени, допускающего |
|
|
сортировку, связанный с шабло- |
|
|
ном формата «s» |
|
|
|
string TimeSeparator |
|
Строка, разделяющая компонен- |
|
|
ты времени – часы, минуты и се- |
|
|
кунды |
|
|
|
string |
|
Шаблон формата для значения |
UniversalSortableDateTimePattern |
|
всемирной даты и времени, до- |
|
|
|
|
|
пускающего сортировку, связан- |
|
|
ный с шаблоном формата «u» |
|
|
|
|
463 |
|
|
онной системой |
|
|
static CultureInfo |
Возвращает объект CultureInfo, не за- |
InvariantCulture |
висящий от языка и региональных па- |
|
|
|
раметров (инвариантный) |
|
|
bool IsNeutralCulture |
Возвращает значение, показывающее, |
|
представляет ли текущий CultureInfo |
|
нейтральный язык и региональные па- |
|
раметры |
|
|
int KeyboardLayoutId |
Получает активный идентификатор |
|
языка ввода (раскладку клавиатуры) |
|
|
int LCID |
Возвращает идентификатор языка и |
|
региональных параметров |
|
|
string Name |
Возвращает имя языка и региональ- |
|
ных параметров |
|
|
string NativeName |
Получает имя языка и региональных |
|
параметров, состоящих из языка, |
|
страны или региона и дополнительно- |
|
го набора символов, которые свой- |
|
ственны этому языку |
|
|
NumberFormatInfo NumberFormat |
Объект NumberFormatInfo, определя- |
|
ющий формат отображения чисел, де- |
|
нежной единицы и процентов, соот- |
|
ветствующий языку и региональным |
|
параметрам |
|
|
465
Приложение Д. Объекты файлового ввода-вывода
Объекты для бинарного потокового ввода-вывода рассмотрены в табл.
Д.1-Д.6.
Табл. Д.1 – Основные члены класса System.IO.Stream
Член |
Владелец |
|
Описание |
|
|
|
|
|
Методы |
|
|
|
|
|
|
virtual void |
|
Закрывает текущий поток |
|
Close() |
|
|
|
|
|
|
|
void Dispose() |
IDisposable |
Удаление потока. Все изменения, |
|
|
|
накопленные в буфере, записываются |
|
|
|
в поток, а затем поток закрывается. |
|
|
|
Напрямую вызывать данный метод не |
|
|
|
следует, он вызывается автоматиче- |
|
|
|
ски. |
|
|
|
|
|
virtual void |
|
Если параметр равен false, освобож- |
|
Dispose(bool |
|
дает неуправляемые ресурсы потока, |
|
|
|
||
disposing) |
|
если true – освобождает все ресурсы |
|
|
|
||
|
|
|
|
abstract void |
|
Очищает все буферы данного потока |
|
Flush() |
|
и вызывает запись данных буферов в |
|
|
|
||
|
|
базовое устройство |
|
|
|
|
|
abstract int |
|
Считывает |
последовательность бай- |
Read(byte[] |
|
тов из текущего потока и перемещает |
|
buffer, int |
|
||
|
позицию в потоке на число считанных |
||
offset, int count) |
|
||
|
байтов |
|
|
|
|
|
|
|
|
|
|
virtual int |
|
Считывает байт из потока и переме- |
|
ReadByte() |
|
щает позицию в потоке на один байт, |
|
|
|
||
|
|
или возвращает –1, если достигнут |
|
|
|
конец потока |
|
|
|
|
|
abstract long |
|
Задает позицию в текущем потоке(1) |
|
Seek(long offset, |
|
|
|
SeekOrigin origin) |
|
|
|
|
|
|
|
abstract void |
|
Задает длину текущего потока. Под- |
|
SetLength(long |
|
держивается не для всех типов пото- |
|
|
|
||
value) |
|
ков. |
|
|
|
|
|
|
|
|
|
|
466 |
|
|
abstract void |
|
Записывает последовательность бай- |
|
Write(byte[] |
|
тов в текущий поток и перемещает |
|
buffer, int |
|
||
|
текущую позицию в нем вперед на |
||
offset, int count) |
|
||
|
число записанных байтов |
||
|
|
||
|
|
|
|
virtual void |
|
Записывает байт в текущее положе- |
|
WriteByte(byte |
|
ние в потоке и перемещает позицию в |
|
|
|
||
value) |
|
потоке вперед на один байт |
|
|
|
||
|
|
|
|
|
Поля |
|
|
|
|
|
|
static readonly |
|
Класс Stream без резервного храни- |
|
Stream Null |
|
лища |
(2) |
|
|
|
|
|
|
|
|
|
Свойства |
|
|
|
|
|
|
abstract bool |
|
Показывает, поддерживает ли теку- |
|
CanRead |
|
щий поток возможность чтения |
|
|
|
||
|
|
|
|
abstract bool |
|
Показывает, поддерживается ли в те- |
|
CanSeek |
|
кущем потоке возможность переме- |
|
|
|
||
|
|
щения |
|
|
|
|
|
abstract bool |
|
Показывает, поддерживает ли теку- |
|
CanWrite |
|
щий поток возможность записи |
|
|
|
||
|
|
|
|
abstract long |
|
Длина потока в байтах |
|
Length |
|
|
|
|
|
|
|
abstract long |
|
Получает или задает (если это разре- |
|
Position |
|
шено) позицию в текущем потоке |
|
|
|
||
|
|
|
|
Примечания: |
|
|
|
(1)Перечисление System.IO.SeekOrigin содержит три константы для типа смещения – Begin (относительно начала потока), Current (относительно текущей позиции) и End (относительно конца потока).
(2)Запись в поток Null приводит к тому, что данные не записываются. Прочитать из него тоже ничего нельзя. Нужен он в тех случаях, когда необходимо переправить куда-то поток постоянно поступающих данных (например, из сетевого канала), не затрачивая ресурсы операционной системы. Аналог – перенаправление вывода в командной строке в виртуальный файл nul или запись данных в этот файл, например,
copy 1.txt nul
copy 1.txt 2.txt > nul
и т.д.
467
Для перечисленных ниже классов-потомков IO.Stream (табл. Д.2-Д.4) указаны только новые члены, отсутствующие в базовом классе, или переопределенные члены, чье поведение существенно отличается от базовой функциональности.
Табл. Д.2 – Основные члены класса System.IO.Compression.GZipStream
Член |
Владелец |
Описание |
|
|
|
|
Конструкторы |
|
|
|
|
GZipStream(Stream |
|
Инициализирует новый экземпляр |
stream, CompressionMode |
|
класса с использованием заданного |
|
|
|
mode) |
|
базового потока и режима сжатия(1) |
|
|
|
GZipStream(Stream |
|
То же самое, но с указанием – сле- |
stream, CompressionMode |
|
дует ли при закрытии потока GZip |
mode, bool leaveOpen) |
|
|
|
оставить базовый поток открытым |
|
|
|
|
|
|
|
|
Методы |
|
|
|
|
override void |
Stream |
Это свойство не поддерживается и |
SetLength(long value) |
|
всегда вызывает исключительную |
|
|
|
|
|
ситуацию NotSupportedException |
|
|
|
|
Свойства |
|
|
|
|
Stream BaseStream |
|
Возвращает ссылку на базовый по- |
|
|
ток |
|
|
|
override long Length |
Stream |
Это свойство не поддерживается и |
|
|
всегда вызывает исключительную |
|
|
ситуацию NotSupportedException |
|
|
|
override long Position |
Stream |
Аналогично |
|
|
|
Примечания:
(1) Режим сжатия System.IO.Compression.CompressionMode содержит две константы – Decompress (распаковка) и Compress (упаковка).
Табл. Д.3 – Основные члены класса System.IO.FileStream
Член |
Владелец |
Описание |
|
|
|
|
Конструкторы |
|
|
|
|
FileStream(string path, |
|
Инициализирует новый экземпляр |
FileMode mode, |
|
класса с указанным путем, режи- |
|
|
|
FileAccess access) |
|
мом создания(1) и режимом досту- |
|
|
|
|
|
па(2) |
|
468 |
|
FileStream(...) |
|
Большой набор других конструк- |
|
|
торов (см. MSDN) |
|
|
|
|
Методы |
|
|
|
|
virtual void Lock(long |
|
Предотвращает изменение потока |
position, long length) |
|
другими процессами, пока разре- |
|
|
|
|
|
шен доступ для чтения |
|
|
|
virtual void Unlock(long |
|
Разрешает доступ других процес- |
position, long length) |
|
сов ко всему ранее заблокирован- |
|
|
|
|
|
ному файлу или его части |
|
|
|
|
Свойства |
|
|
|
|
string Name |
|
Возвращает передаваемое кон- |
|
|
структору имя файла |
|
|
|
Примечания: |
|
|
(1) Режим создания System.IO.FileMode содержит следующие констан-
ты:
•CreateNew – создается новый файл (если такой файл уже существует, создается исключение IOException);
•Create – создается новый файл (если такой файл уже существует, то он будет перезаписан);
•Open – открывается существующий файл (если файл не существует,
создается исключение FileNotFoundException);
•OpenOrCreate – файл открывается, если он существует, в противном случае создается новый файл;
•Truncate – открывается существующий файл, после чего его содержимое удаляется, т.е. размер становится равен нулю;
•Append – если файл существует, то он открывается, и текущей становится позиция в конце файла, иначе создается новый файл.
(2) Режим доступа System.IO.FileAccess содержит следующие констан-
ты:
•Read – доступ для чтения файла;
•Write – доступ для записи файла;
•ReadWrite – доступ для чтения и записи.
Табл. Д.4 – Основные члены класса System.IO.MemoryStream
Член |
Владелец |
|
Описание |
|
|
|
|
|
469 |
|
|
|
Конструкторы |
|
|
|
|
|
|
MemoryStream(...) |
|
Большой набор конструкторов (см. |
|
|
|
MSDN) |
|
|
|
|
|
|
Методы |
|
|
|
|
|
|
virtual byte[] |
|
Возвращает массив байтов, из ко- |
|
GetBuffer() |
|
торого был создан данный поток |
|
|
|
||
|
|
|
|
virtual byte[] ToArray() |
|
Записывает содержимое всего по- |
|
|
|
тока в массив байтов |
|
|
|
|
|
virtual void |
|
Записывает все содержимое данно- |
|
WriteTo(Stream stream) |
|
го потока памяти в другой поток |
|
|
|
||
|
|
|
|
|
Свойства |
|
|
|
|
|
|
virtual int Capacity |
|
Число байтов, выделенных для это- |
|
|
|
го потока |
|
|
|
|
|
Табл. Д.5 – Основные члены класса System.IO.BinaryReader |
|||
|
|
|
|
Член |
Владелец |
|
Описание |
|
|
|
|
|
Конструкторы |
|
|
|
|
|
|
BinaryReader(Stream |
|
Выполняет инициализацию нового |
|
input) |
|
экземпляра класса с базовым пото- |
|
|
|
||
|
|
ком и кодировкой UTF8Encoding |
|
|
|
|
|
BinaryReader(Stream |
|
Выполняет инициализацию нового |
|
input, Encoding |
|
экземпляра класса с базовым пото- |
|
|
|
||
encoding) |
|
ком и указанной кодировкой(1) |
|
|
|
||
|
Методы |
|
|
|
|
|
|
virtual void Close() |
|
Закрывает текущий поток чтения и |
|
|
|
связанный с ним базовый поток |
|
|
|
|
|
virtual void |
|
Если параметр равен false, осво- |
|
Dispose(bool disposing) |
|
бождает |
неуправляемые ресурсы |
|
|
||
|
|
потока, если true – освобождает все |
|
|
|
ресурсы |
|
|
|
|
|
virtual void |
|
Заполняет внутренний буфер ука- |
|
FillBuffer(int numBytes) |
|
занным количеством байтов, кото- |
|
|
|
||
|
|
рые были считаны из потока |
|
|
|
|
|
virtual int PeekChar() |
|
Возвращает следующий доступный |
|
|
|
для чтения символ, не перемещая |
|
|
|
|
|
|
470 |
|
|