System.Web.Services.WebService 类
System.Web.Services.WebService 类定义了 XML Web services 的可选基类，并提供了直接访问常见 ASP.NET 对象（如应用程序和会话状态的对象）的权限。默认情况下，使用 Visual Studio 以托管代码的形式创建的 XML Web services 继承此类。XML Web services 可以继承此类以获得访问 ASP.NET 固有对象（如 Request 和 Session）的权限。
如果 XML Web services 没有继承此类，也可以从 System.Web.HttpContext.Current 访问 ASP.NET 固有对象。实现 XML Web services 的类必须是公共的，并且必须有一个公共的默认构造函数（不带参数的构造函数）。这样，ASP.NET 就能够创建 XML Web services 类的实例以处理传入的 XML Web services 请求。
有关详细信息，请参阅 Inheriting from the WebService Class。
WebService 属性
每个 XML Web services 都需要唯一的命名空间，它可使客户端应用程序区分出可能使用相同方法名称的 XML Web services。在 Visual Studio .NET 中创建的 XML Web services 的默认命名空间是“http://tempuri.org/”。尽管命名空间类似于典型的 URL，但在 Web 浏览器中是不能查看的，它只是一个唯一标识符。
注意：您可能希望在包含有关您所提供的 XML Web services 信息的位置提供一个 Web 页。
WebService 属性提供以下属性：
◆Description
此属性的值包含描述性消息，此消息将在 XML Web services 的说明文件（例如服务说明和服务帮助页）生成后显示给 XML Web services 的潜在用户。
◆Name
此属性的值包含 XML Web services 的名称。默认情况下，该值是实现 XML Web services 的类的名称。Name 属性标识 XML Web services 的 XML 限定名称的本地部分。Name 属性也用于在服务帮助页上显示 XML Web services 的名称。
◆Namespace
此属性的值包含 XML Web services 的默认命名空间。XML 命名空间提供了一种在 XML 文档中创建名称的方法，该名称可由统一资源标识符 (URI) 标识。使用 XML 命名空间，可以唯一标识 XML 文档中的元素或属性。因而，在 XML Web services 的服务说明中，Namespace 被用作与 XML Web services 直接相关的 XML 元素的默认命名空间。如果不指定命名空间，就使用默认命名空间 http://tempuri.org/。
以下示例代码说明了 WebService 属性的用法：
' Visual Basic
http://MyServer/MyWebServices/", _
Description:="此处可以放一些描述性文字。",
Name:="MyFavoritesService")> _
Public Class Service1
Inherits System.Web.Services.WebService
' 实现代码。
End Class // C#
[WebService(Namespace="http://MyServer/MyWebServices/",
Description="此处可以放一些描述性文字。",
Name="MyFavoritesService")]
public class Service1 : System.Web.Services.WebService
{
// 实现代码。
}
|
有关详细信息，请参阅 Using the WebService Attribute。
WebMethod 属性
以托管代码创建 XML Web services 时，通过在 Public 方法声明之前放置 WebMethod 属性可以指定在 XML Web services 中可用的方法。Private 方法不能充当 XML Web services 的入口点，尽管它们可以采用相同的类并且 XML Web services 代码可以调用它们。WebMethod 属性必须应用到可用作 XML Web services 一部分的每种公共方法中。
WebMethod 属性包含配置 XML Web services 行为的几个属性。例如，可以使用此属性在相关服务帮助页提供一个简短说明。
WebMethod 属性提供以下属性：
◆BufferResponse
当设置为 True（默认设置）时，ASP.NET 将响应向下发送到客户端之前先缓存整个响应。缓存是一种非常有效的方法，可以通过减少辅助进程和 Internet 信息服务 (IIS) 进程之间的通信来提高性能。当设置为 False 时，ASP.NET 会将响应缓存在 16 KB 的区块中。通常，只有在不想一次将响应的全部内容都缓存在内存中时，才将此属性设置为 False。例如，正在写回一个将项流出数据库的集合。除非另行指定，否则默认值为 True。
◆CacheDuration
此属性的值指定 ASP.NET 缓存每个唯一参数设置结果所需的秒数。除非另行指定，否则默认值为 0，此设置将禁用结果缓存。
◆Description
此属性的值提供了对 XML Web services 方法的说明，显示于服务帮助页中。除非另行指定，否则默认值为空字符串。
◆EnableSession
当设置为 False（默认设置）时，ASP.NET 将无法访问 XML Web services 方法的会话状态。当设置为 True 时，XML Web services 可以直接从 HttpContext.Current.Session 访问会话状态集合；在继承了 WebService 基类的情况下，也可以使用 WebService.Session 属性进行访问。
◆MessageName
此属性的值使 XML Web services 能够使用别名来唯一标识重载的方法。除非另行指定，否则默认值为方法名。当为 MessageName 指定值后，结果 SOAP 消息会反映出此名称而不是实际的方法名。
◆TransactionOption
此属性的值指定 XML Web services 方法是否可以作为事务的根对象。虽然可以将 TransactionOption 属性设置为 TransactionOption 枚举类型的任意值，但是 XML Web services 方法仅有两种可能行为：它不参与事务（Disabled、NotSupported 和 Supported），或是创建新事务（Required 和 RequiresNew）。除非另行指定，否则默认值为 TransactionOption.Disabled。要使用此属性，需要向 System.EntERPriseServices.dll 添加一个引用。此命名空间包含的方法和属性，提供了可在 COM+ 服务中找到的分布式事务模型。
System.EnterpriseServices.ContextUtil 类允许您使用 SetAbort 或 SetComplete 方法设置该事务。
以下示例代码说明了 WebMethod 属性的用法：
' Visual Basic
Public Class Service1
Inherits System.Web.Services.WebService
CacheDuration:=60, _
Description:="一些描述性的文字",
MessageName:="RetrieveData")> _
Public Function GetBigChunkOfData() As DataSet
' 实现代码
End Function
End Class // C#
public class Service1 : System.Web.Services.WebService
{
[WebMethod(BufferResponse=false,
CacheDuration=60,
Description="一些描述性的文字",
MessageName="RetrieveData")]
public DataSet GetBigChunkOfData()
{
// 实现代码
}
}
|
有关详细信息，请参阅 Using the WebMethod Attribute。
相关 
