|
Глава.15 .Перечислимые.типы.и.битовые.флаги
с ним строка добавляется в итоговую строку, соответствующие же биты считают-
ся учтенными и сбрасываются. Операция повторяется до завершения проверки
всех числовых значений или до сброса все битов экземпляров перечисления.
3. Если после проверки всех числовых значений экземпляр перечисления все
еще не равен нулю, это означает наличие несброшенных битов, которым не со-
поставлены идентификаторы. В этом случае метод возвращает исходное число
экземпляра перечисления в виде строки.
4. Если исходное значение экземпляра перечисления не равно нулю, метод воз-
вращает набор символов, разделенных запятой.
5. Если исходным значением экземпляра перечисления был ноль, а в перечис-
лимом типе есть идентификатор с таким значением, метод возвращает этот
идентификатор.
6. Если алгоритм доходит до данного шага, возвращается 0.
Чтобы получить правильную результирующую строку, тип
Actions
можно
определить и без атрибута
[Flags]
. Для этого достаточно указать формат
"F"
:
// [Flags] // Теперь это просто комментарий
internal enum Actions {
None = 0
Read = 0x0001,
Write = 0x0002,
ReadWrite = Actions.Read | Actions.Write,
Delete = 0x0004,
Query = 0x0008,
Sync = 0x0010
}
Actions actions = Actions.Read | Actions.Delete; // 0x0005
Console.WriteLine(actions.ToString("F")); // "Read, Delete"
Если числовое значение содержит бит, которому не соответствует какой-либо
идентификатор, в возвращаемой строке окажется только десятичное число, равное
исходному значению, и ни одного идентификатора.
Заметьте: идентификаторы, которые вы определяете в перечислимом типе, не
обязаны быть степенью двойки. Например, в типе
Actions
можно описать иденти-
фикатор с именем
All
, имеющий значение
0x001F
. Результатом форматирования
экземпляра типа
Actions
со значением
0x001F
станет строка
"All"
. Других иден-
тификаторов в строке не будет.
Пока мы говорили лишь о преобразовании числовых значений в строку флагов.
Однако вы можете также получить числовое значение строки, содержащей разде-
ленные запятой идентификаторы, воспользовавшись статическим методом
Parse
типа
Enum
или методом
TryParse
. Рассмотрим это на примере:
// Так как Query определяется как 8, 'a' получает начальное значение 8
Actions a = (Actions) Enum.Parse(typeof(Actions), "Query", true);
413
Добавление.методов.к.перечислимым.типам
Console.WriteLine(a.ToString()); // "Query"
// Так как у нас определены и Query, и Read, 'a' получает
// начальное значение 9
Enum.TryParse ("Query, Read", false, out a);
Console.WriteLine(a.ToString()); // "Read, Query"
// Создаем экземпляр перечисления Actions enum со значением 28
a = (Actions) Enum.Parse(typeof(Actions), "28", false);
Console.WriteLine(a.ToString()); // "Delete, Query, Sync"
При вызове методов
Parse
и
TryParse
выполняются следующие действия:
1. Удаляются все пробелы в начале и конце строки.
2. Если первым символом в строке является цифра, знак «плюс» (+) или знак
«минус» (–), строка считается числом и возвращается экземпляр перечисления,
числовое значение которого совпадает с числом, полученным в результате пре-
образования строки.
3. Переданная строка разбивается на разделенные запятыми лексемы, и у каждой
лексемы удаляются все пробелы в начале и конце.
4. Выполняется поиск каждой строки лексемы среди идентификаторов перечисле-
ния. Если символ найти не удается, метод
Parse
генерирует исключение
System.
ArgumentException
, а метод
TryParse
возвращает значение
false
. При обнару-
жении символа его числовое значение путем дизъюнкции (
OR
) присоединяется
к результирующему значению, и метод переходит к анализу следующего символа.
5. После обнаружения и проверки всех лексем результат возвращается программе.
Никогда не следует применять метод
IsDefined
с перечислимыми типами би-
товых флагов. Это не будет работать по двум причинам:
Переданную ему строку метод не разбивает на отдельные лексемы, а ищет целиком,
вместе с запятыми. Однако в перечислении не может присутствовать идентифи-
катор, содержащий запятые, а значит, результат поиска всегда будет нулевым.
После передачи ему числового значения метод ищет всего один символ перечис-
лимого типа, значение которого совпадает с переданным числом. Для битовых
флагов вероятность получения положительного результата при таком сравнении
ничтожно мала, и обычно метод возвращает значение
false
.
Do'stlaringiz bilan baham: |
