Udostępnij za pośrednictwem


WebService Klasa

Definicja

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 T z elementu IServiceProvider.

GetKeyedServices(IServiceProvider, Type, Object)

Pobiera wyliczenie usług typu serviceType z klasy IServiceProvider.

GetKeyedServices<T>(IServiceProvider, Object)

Pobiera wyliczenie usług typu T z klasy IServiceProvider.

GetRequiredKeyedService(IServiceProvider, Type, Object)

Pobiera usługę typu serviceType z elementu IServiceProvider.

GetRequiredKeyedService<T>(IServiceProvider, Object)

Pobiera usługę typu T z elementu IServiceProvider.

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 serviceType z elementu IServiceProvider.

GetRequiredService<T>(IServiceProvider)

Pobierz usługę typu T z elementu IServiceProvider.

GetService<T>(IServiceProvider)

Pobierz usługę typu T z elementu IServiceProvider.

GetServices(IServiceProvider, Type)

Pobierz wyliczenie usług typu serviceType z klasy IServiceProvider.

GetServices<T>(IServiceProvider)

Pobierz wyliczenie usług typu T z klasy IServiceProvider.

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.

Dotyczy