WebService Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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) |