WebService Klasse

Definition

Namespace:

System.Web.Services

Assembly:

System.Web.Services.dll

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.

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

public class WebService : System.ComponentModel.MarshalByValueComponent

type WebService = class
    inherit MarshalByValueComponent

Public Class WebService
Inherits MarshalByValueComponent

Vererbung

Object

MarshalByValueComponent

WebService

Abgeleitet

System.Workflow.Activities.WorkflowWebService

Beispiele

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

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

Hinweise

Wenn Sie keinen Zugriff auf die allgemeinen ASP.NET-Objekte benötigen, können Sie trotzdem einen XML-Webdienst erstellen, ohne von WebServiceabzuleiten. Auf weitere ASP.NET-Objekte kann über Contextzugegriffen werden.

XML-Webdienstmethoden, die die OneWay -Eigenschaft von oder SoapDocumentMethodAttributeSoapRpcMethodAttribute auf truefestgelegt haben, haben keinen Zugriff auf ihre HttpContext. Daher gibt der Zugriff auf eine der Eigenschaften der -Klasse innerhalb dieser WebService XML-Webdienstmethode zurück null.

Wenn Sie die .NET Framework XML-Webdienstmethoden der Version 1.0 verwenden, bei denen entweder das SoapRpcMethodAttribute Attribut oder oder SoapDocumentMethodAttribute mit der OneWay Eigenschaft von auf angewendet truewird, haben Sie keinen Zugriff auf sie HttpContext mithilfe der statischen Current Eigenschaft. Um auf die zuzugreifen HttpContext, leiten Sie die Klasse ab, die die XML-Webdienstmethode implementiert, WebService und greifen Sie auf die Context -Eigenschaft zu.

Konstruktoren

WebService()

Initialisiert eine neue Instanz der WebService-Klasse.

Eigenschaften

Application	Ruft das Anwendungsobjekt für die aktuelle HTTP-Anforderung ab.
Container	Ruft den Container für die Komponente ab. (Geerbt von MarshalByValueComponent)
Context	Ruft HttpContext von ASP.NET für die aktuelle Anforderung ab, wodurch der gesamte HTTP-spezifische Kontext gekapselt wird, der durch den HTTP-Server zum Verarbeiten von Webanforderungen verwendet wird.
DesignMode	Ruft einen Wert ab, der angibt, ob sich die Komponente gegenwärtig im Entwurfsmodus befindet. (Geerbt von MarshalByValueComponent)
Events	Ruft die Liste der an diese Komponente angefügten Ereignishandler ab. (Geerbt von MarshalByValueComponent)
Server	Ruft das HttpServerUtility für die aktuelle Anforderung ab.
Session	Ruft die HttpSessionState-Instanz für die aktuelle Anforderung ab.
Site	Ruft die Site der Komponente ab oder legt sie fest. (Geerbt von MarshalByValueComponent)
SoapVersion	Ruft die Version des SOAP-Protokolls ab, mit dem die SOAP-Anforderung an den XML-Webdienst ausgeführt wird.
User	Ruft das User-Objekt des ASP.NET-Servers ab. Kann verwendet werden, um zu authentifizieren, ob ein Benutzer zum Ausführen der Anforderung berechtigt ist.

Methoden

Dispose()	Gibt alle vom MarshalByValueComponent verwendeten Ressourcen frei. (Geerbt von MarshalByValueComponent)
Dispose(Boolean)	Gibt die von MarshalByValueComponent verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von MarshalByValueComponent)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetService(Type)	Ruft die Implementierung von IServiceProvider ab. (Geerbt von MarshalByValueComponent)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden. (Geerbt von MarshalByValueComponent)

Ereignisse

Disposed

Fügt einen Ereignishandler hinzu, der auf das Disposed-Ereignis für die Komponente lauscht. (Geerbt von MarshalByValueComponent)