HttpSimpleClientProtocol Osztály

Definíció

Névtér:: System.Web.Services.Protocols

Szerelvény:: System.Web.Services.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Egy XML-webszolgáltatással való kommunikáció alaposztályát jelöli az egyszerű HTTP-GET és HTTP-POST protokollkötések használatával.

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

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

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

type HttpSimpleClientProtocol = class
    inherit HttpWebClientProtocol

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

Public MustInherit Class HttpSimpleClientProtocol
Inherits HttpWebClientProtocol

Öröklődés: Object

MarshalByRefObject

Component

WebClientProtocol

HttpWebClientProtocol
HttpSimpleClientProtocol

Származtatott: System.Web.Services.Protocols.HttpGetClientProtocol

System.Web.Services.Protocols.HttpPostClientProtocol

Attribútumok: ComVisibleAttribute

Példák

Az alábbi példakód egy proxyosztály, amelyet az Math alábbi XML-webszolgáltatás Wsdl.exe hoz létre. A proxyosztály az HttpGetClientProtocolabsztrakt HttpSimpleClientProtocol osztályból származik.

#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

A következő példakód az Math XML-webszolgáltatás, amelyből az előző proxyosztály létrejött.

#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

Megjegyzések

Ez az osztály határozza meg az XML-webszolgáltatás http-en keresztüli kommunikációjának legtöbb implementációját kódolókkal a paraméterek kódolásához és az értékek közös MIME-formátumokba való visszaadásához. Ezek a kódolók az MimeFormatter osztályból származnak. Alapértelmezés szerint egy proxyosztály, amely HttpSimpleClientProtocol az alkalmazás/x-www-form-urlencoded MIME típus és a válasz egyszerű XML-ben való használatával kódolja a paramétereket. Az attribútum használatával HttpMethodAttribute egyéni mime-formázók is megadhatóak, de a szolgáltatás leírásába és proxygenerálásába nem lehet integrálni.

Notes to Inheritors: Ha felülbírálja ezt az osztályt, bevezethet olyan metódusokat a származtatott osztályban, amelyek egy XML-webszolgáltatás egy adott típusára vonatkoznak. A metódusok egyszerűen rögzítik a paramétereket, és meghívják az alaposztályt a webhelytel való kommunikációhoz. Ha a bevezetett metódusok aszinkronok, hívja meg az és BeginInvoke a EndInvoke metódusokat. Ha a bevezetett metódusok szinkronok, hívja meg a metódust Invoke . A felülírt konstruktor általában az Url XML Web Service metódus URI-jára állítja be a tulajdonságot.

A Web Services Description Language eszköz (Wsdl.exe) egy adott szolgáltatásleírás származtatott osztályait HttpSimpleClientProtocol hozza létre.

Konstruktorok

Name	Description
HttpSimpleClientProtocol()	Inicializálja a HttpSimpleClientProtocol osztály új példányát.

Tulajdonságok

Name	Description
AllowAutoRedirect	Lekérdezi vagy beállítja, hogy az ügyfél automatikusan követi-e a kiszolgáló átirányításait. (Öröklődés forrása HttpWebClientProtocol)
CanRaiseEvents	Beolvas egy értéket, amely jelzi, hogy az összetevő képes-e eseményt létrehozni. (Öröklődés forrása Component)
ClientCertificates	Lekéri az ügyféltanúsítványok gyűjteményét. (Öröklődés forrása HttpWebClientProtocol)
ConnectionGroupName	Lekéri vagy beállítja a kérés kapcsolatcsoportjának nevét. (Öröklődés forrása WebClientProtocol)
Container	Lekéri a IContainer .Component (Öröklődés forrása Component)
CookieContainer	Lekéri vagy beállítja a cookie-k gyűjtését. (Öröklődés forrása HttpWebClientProtocol)
Credentials	Lekéri vagy beállítja a biztonsági hitelesítő adatokat az XML Web Service-ügyfélhitelesítéshez. (Öröklődés forrása WebClientProtocol)
DesignMode	Olyan értéket kap, amely jelzi, hogy az Component aktuálisan tervezési módban van-e. (Öröklődés forrása Component)
EnableDecompression	Lekéri vagy beállít egy értéket, amely jelzi, hogy engedélyezve van-e a dekompresszió ehhez HttpWebClientProtocola beállításhoz. (Öröklődés forrása HttpWebClientProtocol)
Events	Lekéri az ehhez Componentcsatolt eseménykezelők listáját. (Öröklődés forrása Component)
PreAuthenticate	Lekérdezi vagy beállítja, hogy engedélyezve van-e az előzetes hitelesítés. (Öröklődés forrása WebClientProtocol)
Proxy	Lekéri vagy beállítja a proxyadatokat egy XML-webszolgáltatás-kérés tűzfalon keresztüli létrehozásához. (Öröklődés forrása HttpWebClientProtocol)
RequestEncoding	Az Encoding ügyfél kérésének az XML-webszolgáltatáshoz való küldéséhez használt. (Öröklődés forrása WebClientProtocol)
Site	Lekéri vagy megadja a ISite értékét a Component-hez. (Öröklődés forrása Component)
Timeout	Azt az időt jelzi, amikor egy XML-webszolgáltatás-ügyfél megvárja a szinkron XML-webszolgáltatás-kérésre adott választ (ezredmásodpercben). (Öröklődés forrása WebClientProtocol)
UnsafeAuthenticatedConnectionSharing	Lekéri vagy beállít egy értéket, amely jelzi, hogy engedélyezve van-e a kapcsolatmegosztás, ha az ügyfél NTLM-hitelesítéssel csatlakozik az XML-webszolgáltatást futtató webkiszolgálóhoz. (Öröklődés forrása HttpWebClientProtocol)
Url	Lekéri vagy beállítja az ügyfél által kért XML-webszolgáltatás alap URL-címét. (Öröklődés forrása WebClientProtocol)
UseDefaultCredentials	Lekéri vagy beállít egy értéket, amely jelzi, hogy a Credentials tulajdonságot a tulajdonság értékére DefaultCredentials szeretné-e állítani. (Öröklődés forrása WebClientProtocol)
UserAgent	Lekéri vagy beállítja az egyes kérésekkel elküldött felhasználói ügynök fejlécének értékét. (Öröklődés forrása HttpWebClientProtocol)

Metódusok

Name	Description
Abort()	Megszakítja egy XML-webszolgáltatás-metódusra irányuló kérést. (Öröklődés forrása WebClientProtocol)
BeginInvoke(String, String, Object[], AsyncCallback, Object)	Elindítja egy XML-webszolgáltatás metódusának aszinkron meghívását.
CancelAsync(Object)	Megszakítja az XML-webszolgáltatás metódusának aszinkron hívását, kivéve, ha a hívás már befejeződött. (Öröklődés forrása HttpWebClientProtocol)
CreateObjRef(Type)	Létrehoz egy objektumot, amely tartalmazza a távoli objektumokkal való kommunikációhoz használt proxy létrehozásához szükséges összes releváns információt. (Öröklődés forrása MarshalByRefObject)
Dispose()	Felszabadítja a .-hez használt összes erőforrást Component. (Öröklődés forrása Component)
Dispose(Boolean)	Felszabadítja a felügyelt erőforrások által Component használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat. (Öröklődés forrása Component)
EndInvoke(IAsyncResult)	Befejezi egy XML-webszolgáltatás-metódus HTTP-t használó aszinkron meghívását.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLifetimeService()	Elavult. Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetService(Type)	Olyan objektumot ad vissza, amely az általa vagy annak által Component Containernyújtott szolgáltatást jelöli. (Öröklődés forrása Component)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetWebRequest(Uri)	Létrehoz egy adott WebRequest URI-t. (Öröklődés forrása HttpWebClientProtocol)
GetWebResponse(WebRequest, IAsyncResult)	Aszinkron kérés válaszát adja vissza egy XML Web Service-metódusnak. (Öröklődés forrása HttpWebClientProtocol)
GetWebResponse(WebRequest)	Egy xml-webszolgáltatás-metódusra irányuló szinkron kérés válaszát adja vissza. (Öröklődés forrása HttpWebClientProtocol)
InitializeLifetimeService()	Elavult. Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
Invoke(String, String, Object[])	MEGHÍV EGY XML-webszolgáltatás-metódust HTTP használatával.
InvokeAsync(String, String, Object[], SendOrPostCallback, Object)	A megadott metódust aszinkron módon hívja meg egy társított állapot fenntartása közben.
InvokeAsync(String, String, Object[], SendOrPostCallback)	A megadott metódust aszinkron módon hívja meg.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
ToString()	String A ( ha van) nevet tartalmazó értéket Componentad vissza. Ezt a módszert nem szabad felülírni. (Öröklődés forrása Component)

esemény

Name	Description
Disposed	Akkor fordul elő, ha az összetevőt a metódus hívása megsemmisíti Dispose() . (Öröklődés forrása Component)

A következőre érvényes:

Szálbiztonság

Ez a típus szálbiztos.

Lásd még

SoapHttpClientProtocol

Visszajelzés

Hasznosnak találta ezt az oldalt?