WebService Třída

Definice

Obor názvů:

System.Web.Services

Sestavení:

System.Web.Services.dll

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::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 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)

Metody rozšíření

GetKeyedService<T>(IServiceProvider, Object)	Získá službu typu T z .IServiceProvider
GetKeyedServices(IServiceProvider, Type, Object)	Získá výčet služeb typu serviceType z IServiceProvider.
GetKeyedServices<T>(IServiceProvider, Object)	Získá výčet služeb typu T z IServiceProvider.
GetRequiredKeyedService(IServiceProvider, Type, Object)	Získá službu typu serviceType z .IServiceProvider
GetRequiredKeyedService<T>(IServiceProvider, Object)	Získá službu typu T z .IServiceProvider
CreateAsyncScope(IServiceProvider)	Vytvoří nový AsyncServiceScope , který lze použít k vyřešení služeb s vymezeným oborem.
CreateScope(IServiceProvider)	Vytvoří nový IServiceScope , který lze použít k vyřešení služeb s vymezeným oborem.
GetRequiredService(IServiceProvider, Type)	Získejte službu typu serviceType z .IServiceProvider
GetRequiredService<T>(IServiceProvider)	Získejte službu typu T z .IServiceProvider
GetService<T>(IServiceProvider)	Získejte službu typu T z .IServiceProvider
GetServices(IServiceProvider, Type)	Získejte výčet služeb typu serviceType z .IServiceProvider
GetServices<T>(IServiceProvider)	Získejte výčet služeb typu T z .IServiceProvider
GetFakeLogCollector(IServiceProvider)	Získá objekt, který shromažďuje záznamy protokolu odeslané do falešné protokolovací nástroje.
GetFakeRedactionCollector(IServiceProvider)	Získá falešné redactor kolektor instance z kontejneru injektáž závislostí.