WebService Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Definuje volitelnou základní třídu pro webové služby XML, která poskytuje přímý přístup k běžným objektům ASP.NET, jako je stav aplikace a relace.
public ref class WebService : System::ComponentModel::MarshalByValueComponentpublic class WebService : System.ComponentModel.MarshalByValueComponenttype WebService = class
inherit MarshalByValueComponentPublic Class WebService
Inherits MarshalByValueComponent- Dědičnost
- Odvozené
Příklady
Následující příklad vytvoří webovou službu XML odvozenou z WebService, aby bylo možné použít Context vlastnost k získání času požadavku na serveru.
<%@ WebService Language="C#" Class="Util" %>
using System;
using System.Web.Services;
public class Util: WebService {
[ WebMethod(Description="Returns the time as stored on the Server",
EnableSession=false)]
public string Time() {
return Context.Timestamp.TimeOfDay.ToString();
}
}
<%@ WebService Language="VB" Class="Util" %>
Imports System
Imports System.Web.Services
Public Class Util
Inherits WebService
<WebMethod(Description := "Returns the time as stored on the Server", _
EnableSession := False)> _
Public Function Time() As String
Return Context.Timestamp.TimeOfDay.ToString()
End Function
End Class
Poznámky
Pokud nepotřebujete přístup k běžným objektům ASP.NET, můžete přesto vytvořit webovou službu XML bez odvození z WebService. Další objekty ASP.NET jsou přístupné prostřednictvím Context.
Metody webové služby XML, které mají OneWay vlastnost nebo SoapRpcMethodAttributeSoapDocumentMethodAttribute nastavenou na true, nemají přístup ke svému HttpContextobjektu . Přístup k libovolné vlastnosti WebService třídy z této metody webové služby XML proto vrátí null.
Pokud používáte metody webové služby XML rozhraní .NET Framework verze 1.0, které mají SoapRpcMethodAttribute atribut OneWay nebo SoapDocumentMethodAttribute s vlastností nastavenou na true, nemají přístup k jejich HttpContext pomocí statické Current vlastnosti. Chcete-li získat přístup k objektu HttpContext, odvodit třídu implementují metodu webové služby XML z WebService a přistupovat k Context vlastnosti .
Konstruktory
| WebService() |
Inicializuje novou instanci WebService třídy . |
Vlastnosti
| Application |
Získá objekt aplikace pro aktuální požadavek HTTP. |
| Container |
Získá kontejner pro komponentu. (Zděděno od MarshalByValueComponent) |
| Context |
Získá ASP.NET HttpContext pro aktuální požadavek, který zapouzdřuje všechny kontexty specifické pro HTTP používané serverem HTTP ke zpracování webových požadavků. |
| DesignMode |
Získá hodnotu označující, zda je komponenta aktuálně v režimu návrhu. (Zděděno od MarshalByValueComponent) |
| Events |
Získá seznam obslužných rutin událostí, které jsou připojeny k této komponentě. (Zděděno od MarshalByValueComponent) |
| Server |
Získá pro HttpServerUtility aktuální požadavek. |
| Session |
HttpSessionState Získá instanci pro aktuální požadavek. |
| Site |
Získá nebo nastaví lokalitu komponenty. (Zděděno od MarshalByValueComponent) |
| SoapVersion |
Získá verzi protokolu SOAP použitý k provedení požadavku SOAP webové služby XML. |
| User |
Získá ASP.NET objekt serveru User . Dá se použít k ověření, jestli má uživatel oprávnění ke spuštění požadavku. |
Metody
| Dispose() |
Uvolní všechny prostředky používané nástrojem MarshalByValueComponent. (Zděděno od MarshalByValueComponent) |
| Dispose(Boolean) |
Uvolní nespravované prostředky používané nástrojem MarshalByValueComponent a volitelně uvolní spravované prostředky. (Zděděno od MarshalByValueComponent) |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
| GetService(Type) |
Získá implementátor objektu IServiceProvider. (Zděděno od MarshalByValueComponent) |
| GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| ToString() |
String Vrátí hodnotu obsahující název , Componentpokud existuje. Tato metoda by neměla být přepsána. (Zděděno od MarshalByValueComponent) |
Událost
| Disposed |
Přidá obslužnou rutinu události pro naslouchání Disposed události komponenty. (Zděděno od MarshalByValueComponent) |
