‹title›Мой собственный
‹%#ServiceName + " " + GetLocalizedText("WebService") %›
‹/title›
После изменения HTML-содержимого создайте файл Web.config и сохраните его в текущем каталоге. Следующие XML-элементы дают указание среде выполнения использовать ваш пользовательский файл *.aspx, а не DefaultWsdlHelpGenerator.aspx.
‹!--Здесь указывается пользовательский файл *.aspx --›
‹configuration›
‹system.web›
‹webServices›
‹wsdlHelpGenerator href="MyCustomWsdlHelpGenerator.aspx" /›
‹/webServices›
‹/system.web›
‹/configuration›
При запросе своего Web-сервиса вы увидите, что строка заголовка браузера изменится в соответствии с указанным вами пользовательским содержимым. Кстати, если вы захотите отключить генерирование страницы помощи для данного Web-сервиса, вы можете сделать это с помощью элемента ‹remove› в файле Web.config.
‹!-- Отмена генерирования страницы помощи --›
‹configuration›
‹system.web›
‹webServices›
‹protocols›
‹!-- Этот элемент отменяет генерирование WSDL-документа --›
‹remove name="Documentation"/›
‹/protocols›
‹/webServices›
‹/system.web›
‹/configuration›
Исходный код. Файлы примера HelloWorldWebService размещены в подкаталоге, соответствующем главе 25.
Создав Web-сервис XML вручную, давайте посмотрим, как это делается в Visual Studio 2005. Выбрав File→New→Web Site из меню, создайте новый C#-проект Web-сервиса XML с именем MagicEightBallWebService и сохраните этот проект на своем локальном диске (рис. 25.3).
Замечание. Как и в случае Web-узла ASP.NET, файлы *.sln проектов Web-сервисов XML, созданных в Visual Studio 2005, размещаются в папке Мои документы\Visual Studio 2005\ Projects.
Рис. 25.3. Проект Web-сервиса XML в Visual Studio 2005
После щелчка на кнопке OK в окне создания сервиса Visual Studio 2005 будет сгенерирован файл Service.asmx, определяющий следующую директиву ‹%@WebService%›.
‹%@ WebService Language="C#" CodeBehind="~/App_Code/Servicе.cs" Class="Service" %›
Обратите внимание на то, что здесь используется атрибут CodeBehind, чтобы указать имя файла с программным кодом C#, определяющим соответствующий тип класса (этот файл по умолчанию размещается в каталоге App_Code проекта). По умолчанию Service.cs определяется так.
using System;
using System.Web;
using System.Web.Services;
using System.Web.Services.Protocols;
[WebService(Namespace="http://tempuri.org/")]
[WebServiceBinding(ConformsTo=WsiProfiles.BasicProfile1_1)]
public class Service: System.Web.Services.WebService {
public Service() { }
public string HelloWorld() {
return "Hello World";
}
}
В отличие от предыдущего примера HelloWorldWebService, здесь класс Service получается из базового класса System.Web.Services.WebService. Члены, определенные этим типом, будут рассмотрены чуть позже, а здесь достаточно подчеркнуть, что получать класс Service именно из этого базового класса совсем не обязательно.
Также обратите внимание на то, что класс Service имеет два (также необязательных) атрибута, [WebService] и [WebServiceBinding]. Роль этих атрибутов тоже будет рассмотрена немного позже.
Ваш Web-сервис XML MagicEightBall будет имитировать классическую говорящую игрушку, сообщающую предсказания. Для этого добавьте в класс Service следующий метод (существующий Web-метод HelloWorld() можно удалить).
[WebMethod]
public string TellFortune(string вопросПользователя) {
string[] answers
// Возвращение случайного ответа на вопрос.
Random r = new Random();
return string.Format("{0}? {1}", вопросПользователя, answers[r.Next(answers.Length)]);
}
