WebService Třída

Definice

Obor názvů:

System.Web.Services

Sestavení:

System.Web.Services.dll

Definuje volitelnou základní třídu webových služeb XML, která poskytuje přímý přístup k běžným objektům ASP.NET, jako je například stav aplikace a relace.

public ref class WebService : System::ComponentModel::MarshalByValueComponent

public class WebService : System.ComponentModel.MarshalByValueComponent

type WebService = class
    inherit MarshalByValueComponent

Public Class WebService
Inherits MarshalByValueComponent

Dědičnost

Object

MarshalByValueComponent

WebService

Odvozené

System.Workflow.Activities.WorkflowWebService

Příklady

Následující příklad vytvoří webovou službu XML odvozenou z WebService, aby pomocí Context vlastnosti získat čas 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 stále vytvořit webovou službu XML bez odvození z WebService. K dalším objektům ASP.NET lze přistupovat prostřednictvím Context.

Metody webové služby XML, které mají OneWay vlastnost buď SoapRpcMethodAttribute nebo SoapDocumentMethodAttribute nastavena truena , nemají přístup k jejich HttpContext. Jako takové, přístup k jakékoli vlastnosti WebService třídy, z této xml webové služby metoda vrátit null.

Pokud používáte metody webové služby .NET Framework verze 1.0 XML, které mají SoapRpcMethodAttributeSoapDocumentMethodAttribute buď nebo atribut použitý u nich s OneWay vlastností nastavenou truena , nemáte přístup k jejich HttpContext použití statické Current vlastnosti. Pro přístup HttpContextk , odvození třídy implementace XML webové služby metoda z WebService a přístup k Context vlastnosti.

Konstruktory

Name	Description
WebService()	Inicializuje novou instanci WebService třídy.

Vlastnosti

Name	Description
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 veškerý kontext specifický pro HTTP používaný serverem HTTP ke zpracování webových požadavků.
DesignMode	Získá hodnotu určující, zda komponenta je 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	HttpServerUtility Získá 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 vytvoření požadavku SOAP do webové služby XML.
User	Získá objekt serveru User ASP.NET. Dá se použít k ověření, jestli má uživatel oprávnění k provedení požadavku.

Metody

Name	Description
Dispose()	Uvolní všechny prostředky používané nástrojem MarshalByValueComponent. (Zděděno od MarshalByValueComponent)
Dispose(Boolean)	Uvolní nespravované prostředky používané MarshalByValueComponent a volitelně uvolní spravované prostředky. (Zděděno od MarshalByValueComponent)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetService(Type)	Získá implementátor .IServiceProvider (Zděděno od MarshalByValueComponent)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od MarshalByValueComponent)

Událost

Name	Description
Disposed	Přidá obslužnou rutinu Disposed události pro naslouchání události v komponentě. (Zděděno od MarshalByValueComponent)