WebService-Klasse

Definiert die optionale Basisklasse für XML-Webdienste, wodurch der direkte Zugriff auf gemeinsam genutzte ASP.NET-Objekte (z. B. auf den Anwendungs- und Sitzungszustand) ermöglicht wird.

Namespace: System.Web.Services
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public Class WebService
    Inherits MarshalByValueComponent
'Usage
Dim instance As WebService

public class WebService : MarshalByValueComponent

public ref class WebService : public MarshalByValueComponent

public class WebService extends MarshalByValueComponent

public class WebService extends MarshalByValueComponent

Hinweise

Wenn Sie den Zugriff auf gemeinsam genutzte ASP.NET-Objekte nicht benötigen, können Sie trotzdem einen XML-Webdienst erstellen, ohne eine Ableitung von WebService durchzuführen. Auf weitere ASP.NET-Objekte kann über Context zugegriffen werden.

XML-Webdienstmethoden, deren OneWay-Eigenschaft von SoapRpcMethodAttribute oder SoapDocumentMethodAttribute auf true festgelegt ist, können nicht auf ihren HttpContext zugreifen. Daher wird beim Zugriff auf eine beliebige Eigenschaft der WebService-Klasse über diese XML-Webdienstmethode NULL (Nothing in Visual Basic) zurückgegeben.

Wenn Sie XML-Webdienstmethoden von .NET Framework, Version 1.0, verwenden, auf die das SoapRpcMethodAttribute-Attribut oder das SoapDocumentMethodAttribute-Attribut angewendet wird, wobei die OneWay-Eigenschaft auf true festgelegt ist, kann mit der statischen Current-Eigenschaft nicht auf den HttpContext zugegriffen werden. Leiten Sie für den Zugriff auf HttpContext die Klasse ab, die die XML-Webdienstmethode aus WebService implementiert, und greifen Sie auf die Context-Eigenschaft zu.

Beispiel

Im folgenden Beispiel wird ein XML-Webdienst erstellt, der von WebService abgeleitet wird, um die Context-Eigenschaft zum Abrufen der Uhrzeit der Anforderung an den Server zu verwenden.

<%@ 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
 

<%@ 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();
   }
 }
 

Vererbungshierarchie

System.Object
   System.ComponentModel.MarshalByValueComponent
    System.Web.Services.WebService

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

WebService-Member
System.Web.Services-Namespace