WebService Klass

Definition

Definierar den valfria basklassen för XML-webbtjänster, som ger direkt åtkomst till vanliga ASP.NET objekt, till exempel program- och sessionstillstånd.

public ref class WebService : System::ComponentModel::MarshalByValueComponent
public class WebService : System.ComponentModel.MarshalByValueComponent
type WebService = class
    inherit MarshalByValueComponent
Public Class WebService
Inherits MarshalByValueComponent
Arv
Härledda

Exempel

Exemplet nedan skapar en XML-webbtjänst som härleds från WebService, för att använda Context egenskapen för att hämta tiden för begäran på servern.

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

Kommentarer

Om du inte behöver åtkomst till vanliga ASP.NET objekt kan du fortfarande skapa en XML-webbtjänst utan att härleda från WebService. Ytterligare ASP.NET objekt kan nås via Context.

XML-webbtjänstmetoder som har OneWay egenskapen antingen SoapRpcMethodAttribute eller SoapDocumentMethodAttribute inställd på true, har inte åtkomst till deras HttpContext. Därför returnerar WebServiceåtkomst till någon av egenskaperna för null klassen från xml-webbtjänstmetoden .

Om du använder xml-webbtjänstmetoderna .NET Framework version 1.0 som antingen har attributet SoapRpcMethodAttribute eller SoapDocumentMethodAttribute som tillämpas på dem med egenskapen OneWay inställd på true, har du inte åtkomst till deras HttpContext med egenskapen static Current. För att komma åt HttpContext, härled klassen som implementerar XML-webbtjänstmetoden från WebService och få åtkomst till Context egenskapen.

Konstruktorer

Name Description
WebService()

Initierar en ny instans av WebService klassen.

Egenskaper

Name Description
Application

Hämtar programobjektet för den aktuella HTTP-begäran.

Container

Hämtar containern för komponenten.

(Ärvd från MarshalByValueComponent)
Context

Hämtar ASP.NET HttpContext för den aktuella begäran, som kapslar in all HTTP-specifik kontext som används av HTTP-servern för att bearbeta webbbegäranden.

DesignMode

Hämtar ett värde som anger om komponenten för närvarande är i designläge.

(Ärvd från MarshalByValueComponent)
Events

Hämtar listan över händelsehanterare som är kopplade till den här komponenten.

(Ärvd från MarshalByValueComponent)
Server

HttpServerUtility Hämtar för den aktuella begäran.

Session

Hämtar instansen HttpSessionState för den aktuella begäran.

Site

Hämtar eller anger komponentens plats.

(Ärvd från MarshalByValueComponent)
SoapVersion

Hämtar versionen av SOAP-protokollet som används för att göra SOAP-begäran till XML-webbtjänsten.

User

Hämtar objektet ASP.NET server User. Kan användas för att autentisera om en användare har behörighet att köra begäran.

Metoder

Name Description
Dispose()

Släpper alla resurser som används av MarshalByValueComponent.

(Ärvd från MarshalByValueComponent)
Dispose(Boolean)

Släpper de ohanterade resurser som används av MarshalByValueComponent och släpper eventuellt de hanterade resurserna.

(Ärvd från MarshalByValueComponent)
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetService(Type)

Hämtar implementer för IServiceProvider.

(Ärvd från MarshalByValueComponent)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Returnerar ett String som innehåller namnet på Component, om det finns. Den här metoden bör inte åsidosättas.

(Ärvd från MarshalByValueComponent)

Händelser

Name Description
Disposed

Lägger till en händelsehanterare för att Disposed lyssna på händelsen på komponenten.

(Ärvd från MarshalByValueComponent)

Gäller för