WebService Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Definiuje opcjonalną klasę bazową dla usług sieci Web XML, która zapewnia bezpośredni dostęp do typowych obiektów ASP.NET, takich jak aplikacja i stan sesji.
public ref class WebService : System::ComponentModel::MarshalByValueComponent
public class WebService : System.ComponentModel.MarshalByValueComponent
type WebService = class
inherit MarshalByValueComponent
Public Class WebService
Inherits MarshalByValueComponent
- Dziedziczenie
- Pochodne
Przykłady
Poniższy przykład tworzy usługę sieci Web XML pochodzącą z WebServiceklasy , aby użyć Context właściwości w celu uzyskania czasu żądania na serwerze.
<%@ 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
Uwagi
Jeśli nie potrzebujesz dostępu do typowych obiektów ASP.NET, nadal możesz utworzyć usługę sieci Web XML bez wyprowadzania z WebServiceelementu . Dostęp do dodatkowych obiektów ASP.NET można uzyskać za pośrednictwem polecenia Context.
Metody usługi sieci Web XML, które mają właściwość lub ustawioną na true
, nie mają dostępu do elementu HttpContext.SoapDocumentMethodAttributeSoapRpcMethodAttributeOneWay W związku z tym uzyskiwanie dostępu do dowolnych WebService właściwości klasy z poziomu tej metody usługi sieci Web XML zwraca wartość null
.
Jeśli używasz metod usługi sieci Web .NET Framework w wersji 1.0 XML, które mają SoapRpcMethodAttribute do nich zastosowany atrybut lub SoapDocumentMethodAttribute z właściwością OneWay ustawioną na true
, nie mają dostępu do ich HttpContext przy użyciu właściwości statycznejCurrent. Aby uzyskać dostęp do klasy , należy utworzyć klasę HttpContextimplementowania metody usługi sieci Web XML z WebService właściwości i uzyskać dostęp do Context jej właściwości.
Konstruktory
WebService() |
Inicjuje nowe wystąpienie klasy WebService. |
Właściwości
Application |
Pobiera obiekt aplikacji dla bieżącego żądania HTTP. |
Container |
Pobiera kontener dla składnika. (Odziedziczone po MarshalByValueComponent) |
Context |
Pobiera ASP.NET HttpContext dla bieżącego żądania, które hermetyzuje cały kontekst specyficzny dla protokołu HTTP używany przez serwer HTTP do przetwarzania żądań sieci Web. |
DesignMode |
Pobiera wartość wskazującą, czy składnik jest obecnie w trybie projektowania. (Odziedziczone po MarshalByValueComponent) |
Events |
Pobiera listę programów obsługi zdarzeń dołączonych do tego składnika. (Odziedziczone po MarshalByValueComponent) |
Server |
Pobiera element HttpServerUtility dla bieżącego żądania. |
Session |
HttpSessionState Pobiera wystąpienie dla bieżącego żądania. |
Site |
Pobiera lub ustawia lokację składnika. (Odziedziczone po MarshalByValueComponent) |
SoapVersion |
Pobiera wersję protokołu SOAP używaną do żądania SOAP do usługi sieci Web XML. |
User |
Pobiera obiekt serwera User ASP.NET. Może służyć do uwierzytelniania, czy użytkownik ma autoryzację do wykonania żądania. |
Metody
Dispose() |
Zwalnia wszelkie zasoby używane przez element MarshalByValueComponent. (Odziedziczone po MarshalByValueComponent) |
Dispose(Boolean) |
Zwalnia zasoby niezarządzane używane przez element MarshalByValueComponent i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po MarshalByValueComponent) |
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetService(Type) |
Pobiera implementator obiektu IServiceProvider. (Odziedziczone po MarshalByValueComponent) |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
ToString() |
Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po MarshalByValueComponent) |
Zdarzenia
Disposed |
Dodaje procedurę obsługi zdarzeń do nasłuchiwania Disposed zdarzenia w składniku. (Odziedziczone po MarshalByValueComponent) |
Metody rozszerzania
GetKeyedService<T>(IServiceProvider, Object) |
Pobiera usługę typu |
GetKeyedServices(IServiceProvider, Type, Object) |
Pobiera wyliczenie usług typu |
GetKeyedServices<T>(IServiceProvider, Object) |
Pobiera wyliczenie usług typu |
GetRequiredKeyedService(IServiceProvider, Type, Object) |
Pobiera usługę typu |
GetRequiredKeyedService<T>(IServiceProvider, Object) |
Pobiera usługę typu |
CreateAsyncScope(IServiceProvider) |
Tworzy nową AsyncServiceScope , która może służyć do rozwiązywania problemów z usługami o określonym zakresie. |
CreateScope(IServiceProvider) |
Tworzy nową IServiceScope , która może służyć do rozwiązywania problemów z usługami o określonym zakresie. |
GetRequiredService(IServiceProvider, Type) |
Pobierz usługę typu |
GetRequiredService<T>(IServiceProvider) |
Pobierz usługę typu |
GetService<T>(IServiceProvider) |
Pobierz usługę typu |
GetServices(IServiceProvider, Type) |
Pobierz wyliczenie usług typu |
GetServices<T>(IServiceProvider) |
Pobierz wyliczenie usług typu |
GetFakeLogCollector(IServiceProvider) |
Pobiera obiekt zbierający rekordy dziennika wysyłane do fałszywego rejestratora. |
GetFakeRedactionCollector(IServiceProvider) |
Pobiera fałszywe wystąpienie modułu zbierającego redactor z kontenera wstrzykiwania zależności. |