Sdílet prostřednictvím


WebService Třída

Definice

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

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í.

Platí pro