WebService Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.Services

Zestaw:: System.Web.Services.dll

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: Object

MarshalByValueComponent
WebService

Pochodne: System.Workflow.Activities.WorkflowWebService

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.SoapDocumentMethodAttribute SoapRpcMethodAttribute OneWay 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