HttpSimpleClientProtocol Klasa

Definicja

Przestrzeń nazw:

System.Web.Services.Protocols

Zestaw:

System.Web.Services.dll

Reprezentuje klasę bazową do komunikowania się z usługą sieci Web XML przy użyciu prostych powiązań protokołów HTTP-GET i HTTP-POST.

public ref class HttpSimpleClientProtocol abstract : System::Web::Services::Protocols::HttpWebClientProtocol

[System.Runtime.InteropServices.ComVisible(true)]
public abstract class HttpSimpleClientProtocol : System.Web.Services.Protocols.HttpWebClientProtocol

[<System.Runtime.InteropServices.ComVisible(true)>]
type HttpSimpleClientProtocol = class
    inherit HttpWebClientProtocol

Public MustInherit Class HttpSimpleClientProtocol
Inherits HttpWebClientProtocol

Dziedziczenie

Object

MarshalByRefObject

Component

WebClientProtocol

HttpWebClientProtocol

HttpSimpleClientProtocol

Pochodne

System.Web.Services.Protocols.HttpGetClientProtocol

System.Web.Services.Protocols.HttpPostClientProtocol

Atrybuty

ComVisibleAttribute

Przykłady

Poniższy przykład kodu to klasa serwera proxy wygenerowana przez Wsdl.exe dla poniższej Math usługi sieci Web XML. Klasa serwera proxy pochodzi z HttpGetClientProtocolklasy , która pochodzi z klasy abstrakcyjnej HttpSimpleClientProtocol .

#using <System.Web.Services.dll>
#using <System.Xml.dll>
#using <System.dll>

using namespace System::Diagnostics;
using namespace System::Xml::Serialization;
using namespace System;
using namespace System::Web::Services::Protocols;
using namespace System::Web::Services;

public ref class MyMath: public System::Web::Services::Protocols::HttpGetClientProtocol
{
public:

   [System::Diagnostics::DebuggerStepThroughAttribute]
   MyMath()
   {
      this->Url = "http://www.contoso.com/math.asmx";
   }

   [System::Diagnostics::DebuggerStepThroughAttribute]
   [System::Web::Services::Protocols::HttpMethodAttribute(System::Web::Services::Protocols::XmlReturnReader::typeid,
   System::Web::Services::Protocols::UrlParameterWriter::typeid)]
   [returnvalue:System::Xml::Serialization::XmlRootAttribute("snippet1>",Namespace="http://www.contoso.com/",IsNullable=false)]
   int Add( String^ num1, String^ num2 )
   {
      array<Object^>^temp0 = {num1,num2};
      return  *dynamic_cast<int^>(this->Invoke( "Add", (String::Concat( this->Url, "/Add" )), temp0 ));
   }

   [System::Diagnostics::DebuggerStepThroughAttribute]
   System::IAsyncResult^ BeginAdd( String^ num1, String^ num2, System::AsyncCallback^ callback, Object^ asyncState )
   {
      array<Object^>^temp1 = {num1,num2};
      return this->BeginInvoke( "Add", (String::Concat( this->Url, "/Add" )), temp1, callback, asyncState );
   }

   [System::Diagnostics::DebuggerStepThroughAttribute]
   int EndAdd( System::IAsyncResult^ asyncResult )
   {
      return  *dynamic_cast<int^>(this->EndInvoke( asyncResult ));
   }
};

using System.Diagnostics;
using System.Xml.Serialization;
using System;
using System.Web.Services.Protocols;
using System.Web.Services;

public class MyMath : System.Web.Services.Protocols.HttpGetClientProtocol {

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    public MyMath()
    {
        this.Url = "http://www.contoso.com/math.asmx";
    }

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    [System.Web.Services.Protocols.HttpMethodAttribute(typeof(System.Web.Services.Protocols.XmlReturnReader), typeof(System.Web.Services.Protocols.UrlParameterWriter))]
    [return: System.Xml.Serialization.XmlRootAttribute("int", Namespace = "http://www.contoso.com/", IsNullable = false)]
    public int Add(string num1, string num2)
    {
        return ((int)(this.Invoke("Add", (this.Url + "/Add"),
            new object[] { num1, num2 })));
    }

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    public System.IAsyncResult BeginAdd(string num1, string num2, System.AsyncCallback callback, object asyncState)
    {
        return this.BeginInvoke("Add", (this.Url + "/Add"),
            new object[] { num1, num2 }, callback, asyncState);
    }

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    public int EndAdd(System.IAsyncResult asyncResult)
    {
        return ((int)(this.EndInvoke(asyncResult)));
    }
}

Option Strict On
Option Explicit On

Imports System.Diagnostics
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Xml.Serialization


Public Class MyMath
    Inherits System.Web.Services.Protocols.HttpGetClientProtocol
    
    <System.Diagnostics.DebuggerStepThroughAttribute()>  _
    Public Sub New()
        MyBase.New
        Me.Url = "http://www.contoso.com/math.asmx"
    End Sub
    
    <System.Diagnostics.DebuggerStepThroughAttribute(),  _
     System.Web.Services.Protocols.HttpMethodAttribute(GetType(System.Web.Services.Protocols.XmlReturnReader), GetType(System.Web.Services.Protocols.UrlParameterWriter))>  _
    Public Function Add(ByVal num1 As String, ByVal num2 As String) As <System.Xml.Serialization.XmlRootAttribute("int", [Namespace]:="http://www.contoso.com/", IsNullable:=false)> Integer
        Return CType(Me.Invoke("Add", (Me.Url + "/Add"), New Object() {num1, num2}),Integer)
    End Function
    
    <System.Diagnostics.DebuggerStepThroughAttribute()>  _
    Public Function BeginAdd(ByVal num1 As String, ByVal num2 As String, ByVal callback As System.AsyncCallback, ByVal asyncState As Object) As System.IAsyncResult
        Return Me.BeginInvoke("Add", (Me.Url + "/Add"), New Object() {num1, num2}, callback, asyncState)
    End Function
    
    <System.Diagnostics.DebuggerStepThroughAttribute()>  _
    Public Function EndAdd(ByVal asyncResult As System.IAsyncResult) As Integer
        Return CType(Me.EndInvoke(asyncResult),Integer)
    End Function
End Class

Poniższy przykład kodu to Math usługa sieci Web XML, z której utworzono poprzednią klasę proxy.

#using <System.EnterpriseServices.dll>
#using <System.Web.Services.dll>

using namespace System::Web::Services;
using namespace System;
public ref class Math
{
public:

   [WebMethod]
   int Add( int num1, int num2 )
   {
      return num1 + num2;
   }

};

using System.Web.Services;
using System;

public class Math
{
    [WebMethod]
    public int Add(int num1, int num2)
    {
        return num1 + num2;
    }
}

Imports System.Web.Services

Public Class Math
    <WebMethod()> _
    Public Function Add(num1 As Integer, num2 As Integer)As Integer
    
        Return num1 + num2
    End Function
    
End Class

Uwagi

Ta klasa określa większość implementacji do komunikowania się z usługą sieci Web XML za pośrednictwem protokołu HTTP przy użyciu koderów w celu kodowania parametrów i zwracania wartości do typowych formatów MIME. Te kodery pochodzą z MimeFormatter klasy . Domyślnie klasa serwera proxy wyprowadzająca się z HttpSimpleClientProtocol parametrów koduje przy użyciu typu MIME zakodowanego w formacie application/x-www-form-url oraz odpowiedzi w postaci zwykłego kodu XML. Niestandardowe formatery mime można określić przy użyciu atrybutu HttpMethodAttribute , jednak nie ma obsługi integracji z opisem usługi i generowaniem serwera proxy.

Notes to Inheritors: Po zastąpieniu tej klasy można wprowadzić metody w klasie pochodnej, które są specyficzne dla określonego typu usługi sieci Web XML. Metody po prostu przechwytują parametry i wywołają klasę bazową, aby wykonać pracę komunikacji z lokacją. Jeśli wprowadzone metody są asynchroniczne, wywołaj BeginInvoke metody i EndInvoke . Jeśli wprowadzone metody są synchroniczne, wywołaj metodę Invoke . Konstruktor zastępowany zwykle ustawia Url właściwość na identyfikator URI metody usługi sieci Web XML.

Narzędzie języka opisu usług sieci Web (Wsdl.exe) generuje klasy HttpSimpleClientProtocol pochodne dla danego opisu usługi.

Konstruktory

HttpSimpleClientProtocol()

Inicjuje nowe wystąpienie klasy HttpSimpleClientProtocol.

Właściwości

AllowAutoRedirect	Pobiera lub ustawia, czy klient automatycznie śledzi przekierowania serwera. (Odziedziczone po HttpWebClientProtocol)
CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
ClientCertificates	Pobiera kolekcję certyfikatów klienta. (Odziedziczone po HttpWebClientProtocol)
ConnectionGroupName	Pobiera lub ustawia nazwę grupy połączeń dla żądania. (Odziedziczone po WebClientProtocol)
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
CookieContainer	Pobiera lub ustawia kolekcję plików cookie. (Odziedziczone po HttpWebClientProtocol)
Credentials	Pobiera lub ustawia poświadczenia zabezpieczeń dla uwierzytelniania klienta usługi sieci Web XML. (Odziedziczone po WebClientProtocol)
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
EnableDecompression	Pobiera lub ustawia wartość wskazującą, czy dekompresja jest włączona dla tego elementu HttpWebClientProtocol. (Odziedziczone po HttpWebClientProtocol)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
PreAuthenticate	Pobiera lub ustawia, czy jest włączone wstępne uwierzytelnianie. (Odziedziczone po WebClientProtocol)
Proxy	Pobiera lub ustawia informacje o serwerze proxy na potrzeby tworzenia żądania usługi sieci Web XML za pośrednictwem zapory. (Odziedziczone po HttpWebClientProtocol)
RequestEncoding	Służy Encoding do żądania klienta do usługi sieci Web XML. (Odziedziczone po WebClientProtocol)
Site	Pobiera lub ustawia ISite element .Component (Odziedziczone po Component)
Timeout	Wskazuje czas oczekiwania klienta usługi sieci Web XML na odpowiedź na synchroniczne żądanie usługi sieci Web XML do odebrania (w milisekundach). (Odziedziczone po WebClientProtocol)
UnsafeAuthenticatedConnectionSharing	Pobiera lub ustawia wartość wskazującą, czy udostępnianie połączeń jest włączone, gdy klient używa uwierzytelniania NTLM w celu nawiązania połączenia z serwerem sieci Web hostujących usługę sieci Web XML. (Odziedziczone po HttpWebClientProtocol)
Url	Pobiera lub ustawia podstawowy adres URL usługi sieci Web XML, którego żąda klient. (Odziedziczone po WebClientProtocol)
UseDefaultCredentials	Pobiera lub ustawia wartość wskazującą, czy właściwość ma być ustawiona Credentials na wartość DefaultCredentials właściwości. (Odziedziczone po WebClientProtocol)
UserAgent	Pobiera lub ustawia wartość nagłówka agenta użytkownika, który jest wysyłany z każdym żądaniem. (Odziedziczone po HttpWebClientProtocol)

Metody

Abort()	Anuluje żądanie do metody usługi sieci Web XML. (Odziedziczone po WebClientProtocol)
BeginInvoke(String, String, Object[], AsyncCallback, Object)	Uruchamia asynchroniczne wywołanie metody usługi sieci Web XML.
CancelAsync(Object)	Anuluje asynchroniczne wywołanie metody usługi sieci Web XML, chyba że wywołanie zostało już ukończone. (Odziedziczone po HttpWebClientProtocol)
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Component)
EndInvoke(IAsyncResult)	Kończy asynchroniczne wywołanie metody usługi sieci Web XML przy użyciu protokołu HTTP.
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)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetWebRequest(Uri)	Tworzy element WebRequest dla określonego identyfikatora URI. (Odziedziczone po HttpWebClientProtocol)
GetWebResponse(WebRequest)	Zwraca odpowiedź z synchronicznego żądania do metody usługi sieci Web XML. (Odziedziczone po HttpWebClientProtocol)
GetWebResponse(WebRequest, IAsyncResult)	Zwraca odpowiedź z asynchronicznego żądania do metody usługi sieci Web XML. (Odziedziczone po HttpWebClientProtocol)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
Invoke(String, String, Object[])	Wywołuje metodę usługi sieci Web XML przy użyciu protokołu HTTP.
InvokeAsync(String, String, Object[], SendOrPostCallback)	Wywołuje określoną metodę asynchronicznie.
InvokeAsync(String, String, Object[], SendOrPostCallback, Object)	Wywołuje określoną metodę asynchronicznie przy zachowaniu skojarzonego stanu.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
ToString()	Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny wątkowo.

Zobacz też

• SoapHttpClientProtocol