Teilen über


WebService Klasse

Definition

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
Abgeleitet

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 dennoch 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, auf die entweder das SoapRpcMethodAttribute Attribut oder SoapDocumentMethodAttribute angewendet werden, auf die die OneWay -Eigenschaft auf truefestgelegt ist, haben Sie keinen Zugriff auf sie HttpContext mithilfe der statischen Current Eigenschaft. Um auf zuzugreifen HttpContext, leiten Sie die Klasse ab, die die XML-Webdienstmethode implementiert, von und WebService 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)

Erweiterungsmethoden

GetKeyedService<T>(IServiceProvider, Object)

Ruft einen Dienst vom Typ T aus ab IServiceProvider.

GetKeyedServices(IServiceProvider, Type, Object)

Ruft eine Enumeration von Diensten vom Typ serviceType aus ab IServiceProvider.

GetKeyedServices<T>(IServiceProvider, Object)

Ruft eine Enumeration von Diensten vom Typ T aus ab IServiceProvider.

GetRequiredKeyedService(IServiceProvider, Type, Object)

Ruft einen Dienst vom Typ serviceType aus ab IServiceProvider.

GetRequiredKeyedService<T>(IServiceProvider, Object)

Ruft einen Dienst vom Typ T aus ab IServiceProvider.

CreateAsyncScope(IServiceProvider)

Erstellt eine neue AsyncServiceScope-Schnittstelle, die zum Auflösen von bereichsbezogenen Diensten verwendet werden kann.

CreateScope(IServiceProvider)

Erstellt eine neue IServiceScope-Schnittstelle, die zum Auflösen von bereichsbezogenen Diensten verwendet werden kann.

GetRequiredService(IServiceProvider, Type)

Ruft einen Dienst vom Typ serviceType aus der IServiceProvider-Schnittstelle ab.

GetRequiredService<T>(IServiceProvider)

Ruft einen Dienst vom Typ T aus der IServiceProvider-Schnittstelle ab.

GetService<T>(IServiceProvider)

Ruft einen Dienst vom Typ T aus der IServiceProvider-Schnittstelle ab.

GetServices(IServiceProvider, Type)

Ruft eine Enumeration von Diensten vom Typ serviceType aus der IServiceProvider-Schnittstelle ab.

GetServices<T>(IServiceProvider)

Ruft eine Enumeration von Diensten vom Typ T aus der IServiceProvider-Schnittstelle ab.

GetFakeLogCollector(IServiceProvider)

Ruft das -Objekt ab, das An die gefälschte Protokollierung gesendete Protokolldatensätze sammelt.

GetFakeRedactionCollector(IServiceProvider)

Ruft den gefälschten Redactorsammler instance aus dem Abhängigkeitsinjektionscontainer ab.

Gilt für: