WebService Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Definieert de optionele basisklasse voor XML-webservices, die directe toegang biedt tot algemene ASP.NET-objecten, zoals toepassings- en sessiestatus.
public ref class WebService : System::ComponentModel::MarshalByValueComponent
public class WebService : System.ComponentModel.MarshalByValueComponent
type WebService = class
inherit MarshalByValueComponent
Public Class WebService
Inherits MarshalByValueComponent
- Overname
- Afgeleid
Voorbeelden
In het onderstaande voorbeeld wordt een XML-webservice gemaakt, afgeleid van WebService, om de Context eigenschap te gebruiken om het tijdstip van de aanvraag op de server te verkrijgen.
<%@ 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
Opmerkingen
Als u geen toegang nodig hebt tot de algemene ASP.NET-objecten, kunt u nog steeds een XML-webservice maken zonder afgeleid te zijn van WebService. Aanvullende ASP.NET objecten zijn toegankelijk via Context.
XML-webservicemethoden met de OneWay eigenschap van of SoapRpcMethodAttributeSoapDocumentMethodAttribute ingesteld op true, hebben geen toegang tot hun HttpContext. Als zodanig retourneert nullu toegang tot een van de eigenschappen van de WebService klasse, vanuit die XML-webservicemethode.
Als u gebruikmaakt van de .NET Framework versie 1.0 XML-webservicemethoden waarop de eigenschap SoapRpcMethodAttribute of SoapDocumentMethodAttribute is toegepast met de eigenschap OneWay ingesteld op true, hebt u geen toegang tot hun HttpContext met behulp van de eigenschap static Current. Als u toegang wilt krijgen tot de HttpContextklasse, leidt u de klasse af die de XML-webservicemethode implementeert van WebService en opent u de Context eigenschap.
Constructors
| Name | Description |
|---|---|
| WebService() |
Initialiseert een nieuw exemplaar van de WebService klasse. |
Eigenschappen
| Name | Description |
|---|---|
| Application |
Hiermee haalt u het toepassingsobject op voor de huidige HTTP-aanvraag. |
| Container |
Hiermee haalt u de container voor het onderdeel op. (Overgenomen van MarshalByValueComponent) |
| Context |
Haalt de ASP.NET HttpContext op voor de huidige aanvraag, die alle HTTP-specifieke context inkapselt die door de HTTP-server wordt gebruikt om webaanvragen te verwerken. |
| DesignMode |
Hiermee wordt een waarde opgehaald die aangeeft of het onderdeel zich momenteel in de ontwerpmodus bevindt. (Overgenomen van MarshalByValueComponent) |
| Events |
Hiermee haalt u de lijst met gebeurtenis-handlers op die aan dit onderdeel zijn gekoppeld. (Overgenomen van MarshalByValueComponent) |
| Server |
Hiermee haalt u de HttpServerUtility voor de huidige aanvraag op. |
| Session |
Hiermee haalt u het HttpSessionState exemplaar voor de huidige aanvraag op. |
| Site |
Hiermee haalt u de site van het onderdeel op of stelt u deze in. (Overgenomen van MarshalByValueComponent) |
| SoapVersion |
Hiermee haalt u de versie op van het SOAP-protocol dat wordt gebruikt om de SOAP-aanvraag naar de XML-webservice te verzenden. |
| User |
Hiermee haalt u het ASP.NET-server-User-object op. Kan worden gebruikt om te verifiëren of een gebruiker gemachtigd is om de aanvraag uit te voeren. |
Methoden
| Name | Description |
|---|---|
| Dispose() |
Alle resources die worden gebruikt door de MarshalByValueComponent. (Overgenomen van MarshalByValueComponent) |
| Dispose(Boolean) |
Publiceert de niet-beheerde resources die worden gebruikt door de MarshalByValueComponent beheerde resources en brengt eventueel de beheerde resources vrij. (Overgenomen van MarshalByValueComponent) |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetService(Type) |
Haalt de implementeerfunctie van de IServiceProvider. (Overgenomen van MarshalByValueComponent) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| ToString() |
Retourneert een String met de naam van de Component, indien van toepassing. Deze methode mag niet worden overschreven. (Overgenomen van MarshalByValueComponent) |
gebeurtenis
| Name | Description |
|---|---|
| Disposed |
Voegt een gebeurtenis-handler toe om naar de Disposed gebeurtenis in het onderdeel te luisteren. (Overgenomen van MarshalByValueComponent) |