Настроечные параметры Microsoft .NET

Использование логических переключателей

Логические переключатели служат для определения того, требуется ли записывать трассировочную информацию. Значение логического переключателя устанавливается в 1 или в 0 ( true или false соответственно). Ниже показан пример добавления логического переключателя в раздел <switches>.

<switches>
  <add name="TraceInfo" value="1" />
</switches>

Данный переключатель может быть прочитан в вашем приложении с помощью следующего кода.

C#

static BooleanSwitch bSwitch = new BooleanSwitch("TraceInfo",
  "Write Trace Information");

if(bSwitch.Enabled == true)
{
  Trace.WriteLine("Database Connection Opened");
}

VB.NET

Dim bSwitch As New BooleanSwitch("TraceInfo", _
  "Write Trace Information")

If bSwitch.Enabled = True Then
  Trace.WriteLine("Database Connection Opened")
End If

Если значение переключателя установлено в 1, выполнится метод Trace.WriteLine и запишется трассировочная информация. Если значение переключателя установлено в 0, трассировочная информация не будет записана.

Использование переключателей трассировки

Переключатели трассировки более гибки, чем логические переключатели. Логические переключатели могут только принимать значения true и false, а переключатели трассировки принимают несколько различных значений. Таблица 6.4 содержит список возможных значений переключателя трассировки.

Ниже показано, как добавлять переключатель трассировки в раздел <switches>.

<switches>
  <add name="TraceLevel" value="3" />
</switches>

Затем переключатель можно прочитать в приложении с помощью следующего кода.

C#

TraceSwitch tSwitch =
  new TraceSwitch("TraceLevel", "Tracing Level");

Trace.WriteLineIf(tSwitch.TraceWarning,
  "Here is a warning message");
Trace.WriteLineIf(tSwitch.TraceError, "Here is a error message");

VB.NET

Dim tSwitch As New TraceSwitch("TraceLevel", "Tracing Level")

Trace.WriteLineIf(tSwitch.TraceWarning, "Here is a warning message")
Trace.WriteLineIf(tSwitch.TraceError, "Here is a error message")

Если переключатель TraceLevel установлен в значение 1, то в приемник трассировки будет записано только первое сообщение. Если переключатель TraceLevel установлен в значение 2, то в приемник трассировки будут записаны оба сообщения.

Работа с разделом <assert>

В разделе <assert> настраиваются события, происходящие при вызове методов Trace.Fail или Debug.Assert. По умолчанию открывается окно, выводящее сообщение об ошибке и стек трассировки. Выполнение приложения приостанавливается, и у вас появляется возможность прекратить его выполнение совсем, повторить данную операцию либо игнорировать ошибку. Это полезно при отладке приложения, но данную функцию следует отключить перед отправкой приложения пользователям. Это можно сделать в разделе <assert>, а также сохранить информацию в текстовый файл. Ниже приведен синтаксис раздела <assert>.

<system.diagnostics>
  <assert assertuienabled="true | false" logfilename="file path" />
</system.diagnostics>

В таблице 6.5 показан перечень свойств элемента <assert>.

Ниже приведен пример раздела <assert>.

<system.diagnostics>
  <assert assertuienabled="false"
    logfilename="c:\application\tracelog.txt" />
</system.diagnostics>

Используя этот пример, вы можете подавить вывод окна отладки и задать вывод текста в текстовый файл c:\application\tracelog.txt.

Ключевые моменты <system.diagnostics>

Группа разделов <system.diagnostics> предоставляет настроечные параметры, которые модифицируют поведение трассировки без необходимости в изменении кода или перекомпиляции приложения.

• Раздел <trace> и подраздел <listeners> позволяют указать новые приемники трассировки, сохраняющие информацию в базах данных, текстовых файлах или журналах событий.
• В разделе <switches> добавляются новые логические или трассировочные переключатели, задающие передачу конкретной информации в приемник трассировки или ее игнорирование.
• Раздел <assert> управляет отображением окна отладки и записью информации в текстовый файл.

Изучение группы <system.net>

Группа разделов <system.net> содержит разделы для настройки параметров, относящихся к пространству имен System.Net, включая модули аутентификации, управление соединениями, параметры прокси-сервера и модули запросов интернет. Далее описываются следующие разделы.

• <authenticationModules>. Служит для добавления и удаления модулей аутентификации, используемых для аутентификации запросов интернета.
• <connectionManagement>. Позволяет настраивать максимальное количество соединений с хостами интернета.
• <defaultProxy>. Позволяет настраивать прокси-сервер, используемый для запросов HTTP.
• <settings>. Служит для настройки дополнительных параметров.
• <webRequestModules>. Служит для настройки модулей, которые используются для запроса информации с хостов интернета.