Герберт Шилдт - C# 4.0 полное руководство - 2011
Для указания аргумента по имени служит следующая форма синтаксиса.
имя_параметра : значение
Здесь имя_параметра обозначает имя того параметра, которому передается значение. Разумеется, имя_параметра должно обозначать имя действительного параметра для вызываемого метода.
Ниже приведен простой пример, демонстрирующий применение именованных аргументов. В этом примере создается метод IsFactor (), возвращающий логическое значение true, если первый его параметр нацело делится на второй параметр.
// Применить именованные аргументы, using System;
class NamedArgsDemo {
// Выяснить, делится ли одно значение нацело на другое, static bool IsFactor(int val, int divisor) { if((val % divisor) == 0) return true; return false;
}
static void Main() {
// Ниже демонстрируются разные способы вызова метода IsFactor().
// Вызов с использованием позиционных аргументов, if(IsFactor(10, 2))
Console.WriteLine("2 - множитель 10.");
// Вызов с использованием именованных аргументов, if(IsFactor(val: 10, divisor: 2))
Console.WriteLine("2 - множитель 10.");
// Для именованного аргумента порядок указания не имеет значения, if(IsFactor(divisor: 2, val: 10))
Console.WriteLine("2 - множитель 10.");
// Применить как позиционный, так и именованный аргумент, if(IsFactor(10, divisor: 2))
Console.WriteLine("2 - множитель 10.");
}
}
Выполнение этого кода дает следующий результат.
2 - множитель 10.
2 - множитель 10.
2 - множитель 10.
2 - множитель 10.
Как видите, при каждом вызове метода IsFactor () получается один и тот же результат.
Помимо демонстрации именованного аргумента в действии, приведенный выше пример кода иллюстрирует две важные особенности именованных аргументов. Во-первых, порядок следования аргументов не имеет никакого значения. Например, два следующих вызова метода IsFactor () совершенно равнозначны.
IsFactor(val :10, divisor: 2)
IsFactor(divisor: 2, val: 10)
Независимость от порядка следования является главным преимуществом именованных аргументов. Это означает, что запоминать (или даже знать) порядок следования параметров в вызываемом методе совсем не обязательно. Для работы с СОМ-интерфейсами это может быть очень удобно. И во-вторых, позиционные аргументы можно указывать вместе с именованными в одном и том же вызове, как показано в следующем примере.
IsFactor(10, divisor: 2)
Следует, однако, иметь в виду, что при совместном использовании именованных и позиционных аргументов все позиционные аргументы должны быть указаны перед любыми именованными аргументами.
Именованные аргументы можно также применять вместе с необязательными аргументами. Покажем это на примере вызова метода Display (), рассматривавшегося в предыдущем разделе.
// Указать все аргументы по имени.
Display(stop: 10, str: "это простой тест", start: 0);
// Сделать аргумент start устанавливаемым по умолчанию.
Display(stop: 10, str: "это простой тест") ;
// Указать строку по позиции, аргумент stop — по имени by name,
// тогда как аргумент start — устанавливаемым по умолчанию Display("это простой тест", stop: 10);
Вообще говоря, комбинация именованных и необязательных аргументов позволяет упростить вызовы сложных методов со многими параметрами.
Синтаксис именованных аргументов более многословен, чем у обычных позиционных аргументов, и поэтому для вызова методов чаще всего применяются позиционные аргументы. Но в тех случаях, когда это уместно, именованные аргументы могут быть использованы довольно эффективно.
ПРИМЕЧАНИЕ
Помимо методов, именованные и необязательные аргументы могут применяться в конструкторах, индексаторах и делегатах. (06 индексаторах и делегатах речь пойдет далее в этой книге.)
Метод Main ()
В представленных до сих пор примерах программ использовалась одна форма метода Main (). Но у него имеется также целый ряд перегружаемых форм. Одни из них могут служить для возврата значений, другие — для получения аргументов. В этом разделе рассматриваются и те и другие формы.
Возврат значений из метода Main ()
По завершении программы имеется возможность возвратить конкретное значение из метода Main () вызывающему процессу (зачастую операционной системе). Для этой цели служит следующая форма метода Main ().
static int Main()
Обратите внимание на то, что в этой форме метода Main () объявляется возвращаемый тип int вместо типа void.
Как правило, значение, возвращаемое методом Main (), указывает на нормальное завершение программы или на аварийное ее завершение из-за сложившихся ненормальных условий выполнения. Условно нулевое возвращаемое значение обычно указывает на нормальное завершение программы, а все остальные значения обозначают тип возникшей ошибки.
Передача аргументов методу Main ()
Многие программы принимают так называемые аргументы командной строки, т.е. информацию, которая указывается в командной строке непосредственно после имени программы при ее запуске на выполнение. В программах на C# такие аргументы передаются затем методу Main (). Для получения аргументов служит одна из приведенных ниже форм метода Main ().
static void Main(string[ ] args) static int Main(string[ ] args)
В первой форме метод Main () возвращает значение типа void, а во второй — целое значение, как пояснялось выше. Но в обеих формах аргументы командной строки сохраняются в виде символьных строк в массиве типа string, который передается методу Main (). Длина этого массива (args) должна быть равна числу аргументов командной строки, которое может быть и нулевым.
В качестве примера ниже приведена программа, выводящая все аргументы командной строки, вместе с которыми она вызывается.
// Вывести все аргументы командной строки.
using System;
class CLDemo {
static void Main(string[] args) {
Console.WriteLine("Командная строка содержит " + args.Length +
" аргумента.");
Console.WriteLine("Вот они: ");
for(int i=0; i < args.Length; i++)
Console.WriteLine(args[i]);
}
}
Если программа CLDemo запускается из командной строки следующим образом: CLDemo один два три
то ее выполнение дает такой результат.
Командная строка содержит 3 аргумента.
Вот они: один два три
Для того чтобы стало понятнее, каким образом используются аргументы командной строки, рассмотрим еще один пример программы, в которой применяется простой подстановочный шифр для шифровки или расшифровки сообщений. Шифруемое или расшифровываемое сообщение указывается в командной строке. Применяемый шифр действует довольно просто. Для шифровки слова значение каждой его буквы инкрементируется на 1. Следовательно, Буква "А" становится буквой "Б" и т.д. А для расшифровки слова значение каждой его буквы декрементируется на 1. Разумеется, такой шифр не имеет никакой практической ценности, поскольку его нетрудно разгадать. Тем не менее он может стать приятным развлечением для детей.
// Зашифровать и расшифровать сообщение, используя // простой подстановочный шифр.
using System;
class Cipher {
static int Main(string[] args) {
// Проверить наличие аргументов, if(args.Length < 2) {
Console.WriteLine("ПРИМЕНЕНИЕ: " +
"слово1: <зашифровать>/<расшифровать> " +
"[слово2... словоЫ]"); return 1; // возвратить код неудачного завершения программы
}
// Если аргументы присутствуют, то первым аргументом должно быть // слово <зашифровать> или же слово <расшифровать>. if(args[0] != "зашифровать" & args[0] != "расшифровать") {
Console.WriteLine("Первым аргументом должно быть слово " + "<зашифровать> или <расшифровать>."); return 1; // возвратить код неудачного завершения программы
}
}
Console.Write(" ");
}
Console.WriteLine() ; return 0;
}
}
Для того чтобы воспользоваться этой программой, укажите в командной строке имя программы, затем командное слово "зашифровать" или "расшифровать" и далее сообщение, которое требуется зашифровать или расшифровать. Ниже приведены два примера выполнения данной программы, при условии, что она называется Cipher.
C:Cipher зашифровать один два
пейо егб
C:Cipher расшифровать пейо егб