Настроечные параметры System.Web

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

Раздел <trust> позволяет настраивать уровень безопасности доступа к коду для машины или приложения. Ниже приведен синтаксис раздела <trust>.

<trust level="security level" originUrl="url" />

Свойства раздела <trust> перечислены в табл. 4.24.

Ниже показан пример раздела <trust>.

<trust level="Full" originUrl="" />

Приложения, на которые влияет этот настроечный параметр, будут выполняться с правами доступа Full.

Ключевые моменты <trust>

• Раздел <trust> позволяет указать уровень безопасности, на котором будет работать приложение.

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

Этот маленький раздел содержит всего одно свойство, которое определяет расположение файла сценария проверки на стороне клиента. Ниже приведен синтаксис этого раздела.

<webControls clientScriptsLocation="path" />

Свойство clientScriptsLocation указывает на расположение файла сценария проверки на стороне клиента. Этот файл содержит сценарий, используемый для проверки элементов управления веб на стороне клиента. Ниже показан пример этого раздела.

<webControls clientScriptsLocation= "/aspnet_client/{0}/{1}/" />

Запись {0} будет заменена на имя пространства имен, а {1} – на номер версии .NET Framework. Для ASP.NET 1.1 и пространства имен System.Web результат преобразования выглядит так: aspnet_client/System.Web/1_1_4322/.

Ключевые моменты <webControls>

• Свойство clientScriptsLocation используется для указания пути расположения файлов сценариев проверки.

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

Этот раздел включает параметры для настройки веб-служб XML, создаваемых ASP.NET. Он содержит несколько подразделов, которые работают как разделы, основанные на коллекциях.

Подраздел <protocols>

Подраздел протоколов указывает протоколы, которые могут быть использованы для передачи данных в веб-службы, расположенные на этой машине. Данные в веб-службы отправляются через запрос HTTP, а затем расшифровываются службой. Эти данные включают вызовы методов и параметры. Данный раздел основан на коллекции, так что в него можно добавлять новые элементы, удалять старые и полностью его очищать. Ниже приведен синтаксис добавления протокола.

<protocols>
  <add name="protocol" />
</protocols>

Свойство name используется для указания протокола, добавляемого в раздел <protocols>. Протоколы, которые можно добавить в этот раздел, приведены в табл. 4.25.

Ниже показан пример раздела <protocols>.

<protocols>
  <add name="HttpSoap" />
  <add name="HttpSoap1.2" />
  <add name="Documentation" />
</protocols>

Здесь протоколы становятся доступными при доступе к веб-службам этого сервера. Вы также можете удалить протокол из коллекции, используя элемент <remove>, например:

<protocols>
  <remove name="HttpSoap" />
</protocols>

Протокол HttpSoap теперь недоступен для веб-служб сервера. Можно также использовать элемент <clear /> для удаления всех протоколов, добавленных в коллекцию в предыдущих настроечных файлах.

Подраздел <serviceDescriptionFormatExtensionTypes>

Это подраздел, основанный на коллекции, позволяет указать используемые расширения формата описания службы. Вы можете добавлять в него новые элементы, удалять старые и полностью его очищать. Ниже приведен синтаксис добавления расширения в коллекцию.

<serviceDescriptionFormatExtensionTypes>
  <add type="extension format type" />
</serviceDescriptionFormatExtensionTypes>

Теперь расширение будет добавлено в коллекцию. Ниже показан синтаксис удаления типа из коллекции.

<serviceDescriptionFormatExtensionTypes>
  <remove type="extension type" />
</serviceDescriptionFormatExtensionTypes>

Теперь данный тип будет из коллекции удален. Вы также можете использовать элемент <clear /> для полного удаления всей информации из этого раздела.

Подразделы расширений SOAP

Имеется несколько подразделов расширений SOAP, которые позволяют добавлять на сервер расширения SOAP. Все эти разделы включают одни и те же элементы, показанные в табл. 4.26.

Ниже показан синтаксис добавления расширения в один из подразделов.

<soapExtensionTypes>
  <add type="extension class name" priority="number"
    group="0 | 1" />
</soapExtensionTypes>

В таблице 4.27 приведен перечень свойств элемента <add>.

Ниже показан пример того, как использовать метод add.

<soapExtensionTypes>
  <add type="SOAPExt" priority="1" group="0" />
  <add type="SOAPExt2" priority="2" group="1" />
  <add type="SOAPExt3" priority="1" group="1" />
  <add type="SOAPExt4" priority="2" group="0" />
</soapExtensionTypes>

Эти расширения будут запущены в следующем порядке.

1. SOAPExt
2. SOAPExt4
3. SOAPExt3
4. SOAPExt2

Так как все подразделы основаны на коллекциях, то можно использовать свойства <remove> и <clear />.

Раздел <wsdlHelpGenerator>

Это последний подраздел из раздела <webServices>. Он позволяет указать расположение файла справки по вашим веб-службам. Ниже приведен его синтаксис.

<wsdlHelpGenerator href="file path" />

Свойство href должно указывать непосредственно на физическое расположение файла. Это расположение может быть абсолютным или относительно настроечного файла.

Ключевые моменты <webServices>

• Раздел <protocols> позволяет указать протоколы, которые могут быть использованы для доступа к веб-службам вашего сервера.
• Разделы расширений SOAP позволяют добавлять расширения и задавать их приоритет, используя группы и свойство priority.
• Подраздел <wsdlHelpGenerator> позволяет указать конкретный файл справки, относящейся к вашей веб-службе.