WebService Klasse

Referenz

Definition

Namespace:: System.Web.Services

Assembly:: System.Web.Services.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 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 SoapDocumentMethodAttribute SoapRpcMethodAttribute 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:

Teilen über