SoapHttpClientProtocol 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.

Megadja azt az osztályügyfélt, amelyből a proxyk származnak a SOAP használatakor.

public ref class SoapHttpClientProtocol : System::Web::Services::Protocols::HttpWebClientProtocol

public class SoapHttpClientProtocol : System.Web.Services.Protocols.HttpWebClientProtocol

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

type SoapHttpClientProtocol = class
    inherit HttpWebClientProtocol

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

Public Class SoapHttpClientProtocol
Inherits HttpWebClientProtocol

Öröklődés: Object

MarshalByRefObject

Component

WebClientProtocol

HttpWebClientProtocol
SoapHttpClientProtocol

Attribútumok: ComVisibleAttribute

Példák

Az alábbi példakód egy proxyosztály, amelyet a Wsdl.exe hoz létre az Math XML-webszolgáltatáshoz. A proxyosztály az SoapHttpClientProtocolabsztrakt WebClientProtocol 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;

namespace MyMath
{

   [System::Web::Services::WebServiceBindingAttribute(Name="MyMathSoap",Namespace="http://www.contoso.com/")]
   public ref class MyMath: public System::Web::Services::Protocols::SoapHttpClientProtocol
   {
   public:

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


      [System::Diagnostics::DebuggerStepThroughAttribute]
      [System::Web::Services::Protocols::SoapDocumentMethodAttribute("http://www.contoso.com/Add",
      RequestNamespace="http://www.contoso.com/",ResponseNamespace="http://www.contoso.com/",
      Use=System::Web::Services::Description::SoapBindingUse::Literal,
      ParameterStyle=System::Web::Services::Protocols::SoapParameterStyle::Wrapped)]
      int Add( int num1, int num2 )
      {
         array<Object^>^temp0 = {num1,num2};
         array<Object^>^results = this->Invoke( "Add", temp0 );
         return  *dynamic_cast<int^>(results[ 0 ]);
      }


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


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

   };

}


namespace MyMath {
    using System.Diagnostics;
    using System.Xml.Serialization;
    using System;
    using System.Web.Services.Protocols;
    using System.Web.Services;

    [System.Web.Services.WebServiceBindingAttribute(Name="MyMathSoap", Namespace="http://www.contoso.com/")]
    public class MyMath : System.Web.Services.Protocols.SoapHttpClientProtocol {

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

        [System.Diagnostics.DebuggerStepThroughAttribute()]
        [System.Web.Services.Protocols.SoapDocumentMethodAttribute("http://www.contoso.com/Add", RequestNamespace="http://www.contoso.com/", ResponseNamespace="http://www.contoso.com/", Use=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)]
        public int Add(int num1, int num2) {
            object[] results = this.Invoke("Add", new object[] {num1,
                        num2});
            return ((int)(results[0]));
        }

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

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

Option Strict On
Option Explicit On

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

Namespace MyMath
    
    <System.Web.Services.WebServiceBindingAttribute(Name:="MyMathSoap", [Namespace]:="http://www.contoso.com/")>  _
    Public Class MyMath
        Inherits System.Web.Services.Protocols.SoapHttpClientProtocol
        
        <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.SoapDocumentMethodAttribute("http://www.contoso.com/Add", RequestNamespace:="http://www.contoso.com/", ResponseNamespace:="http://www.contoso.com/", Use:=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle:=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)>  _
        Public Function Add(ByVal num1 As Integer, ByVal num2 As Integer) As Integer
            Dim results() As Object = Me.Invoke("Add", New Object() {num1, num2})
            Return CType(results(0),Integer)
        End Function
        
        <System.Diagnostics.DebuggerStepThroughAttribute()>  _
        Public Function BeginAdd(ByVal num1 As Integer, ByVal num2 As Integer, ByVal callback As System.AsyncCallback, ByVal asyncState As Object) As System.IAsyncResult
            Return Me.BeginInvoke("Add", New Object() {num1, num2}, callback, asyncState)
        End Function
        
        <System.Diagnostics.DebuggerStepThroughAttribute()>  _
        Public Function EndAdd(ByVal asyncResult As System.IAsyncResult) As Integer
            Dim results() As Object = Me.EndInvoke(asyncResult)
            Return CType(results(0),Integer)
        End Function
    End Class
End Namespace

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

Important

Ebben a példában egy szövegdoboz található, amely elfogadja a felhasználói bemenetet, ami potenciális biztonsági fenyegetés. Alapértelmezés szerint ASP.NET weblapok ellenőrzik, hogy a felhasználói bevitel nem tartalmaz-e szkript- vagy HTML-elemeket. További információ: Szkript kihasználása – áttekintés.

<%@ WebService Language="C#" Class="MyMath"%>
 using System.Web.Services;
 using System;
 
 [WebService(Namespace="http://www.contoso.com/")] 
 public class MyMath {
    
    [ WebMethod ]
    public int Add(int num1, int num2) {
        return num1+num2;
    }
 }

<%@ WebService Language="VB" Class="MyMath"%>
Imports System.Web.Services
Imports System

<WebService(Namespace:="http://www.contoso.com/")> _
Public Class MyMath
    <WebMethod()> _
    Public Function Add(num1 As Integer, num2 As Integer) As Integer
        Return num1 + num2
    End Function 'Add
End Class 'Math

Megjegyzések

Ha XML-webszolgáltatás-ügyfelet hoz létre, az XML-webszolgáltatáshoz létre kell hoznia egy közvetett vagy közvetlenül származó WebClientProtocol proxyosztályt. Amikor az XML Web Service-ügyfél SOAP használatával hív meg, a proxyosztálynak a következőből SoapHttpClientProtocolkell származnia HttpWebClientProtocol: . HttpWebClientProtocol, viszont származik WebClientProtocol.

Xml-webszolgáltatással való kommunikációhoz hozzon létre egy proxyosztályt, amely közvetetten vagy közvetlenül a meghívni kívánt XML-webszolgáltatásból WebClientProtocol származik. A proxyosztály manuális létrehozása helyett a Web Services Description Language eszköz (Wsdl.exe) használatával hozzon létre proxyosztályt egy adott XML-webszolgáltatás szolgáltatásleírásához. Ha proxyosztály jön létre a SOAP protokollhoz, a rendszer az XML webszolgáltatás metódusainak szinkron hívásait a Invoke metóduson keresztül indítja el, míg aszinkron hívásokat a metódus és a BeginInvoke EndInvoke metódus használatával.

Megjegyzések az öröklőkhöz

Ha felülbírálja ezt az osztályt, a származtatott osztályban olyan metódusokat is bevezethet, amelyek az XML-webszolgáltatás egy adott típusára vonatkoznak. A metódusok rögzítik a paramétereket, és meghívják az alaposztályt az XML-webszolgáltatással való kommunikációhoz. Ha a bevezetett metódusok aszinkronok, hívja meg a metódust BeginInvoke(String, Object[], AsyncCallback, Object) és a metódust EndInvoke(IAsyncResult) . Ha a bevezetett metódusok szinkronok, hívja meg a metódust Invoke(String, Object[]) . A felülírt konstruktor általában az Url XML Web service metódus URL-címére állítja be a tulajdonságot.

Konstruktorok

Name	Description
SoapHttpClientProtocol()	Inicializálja a SoapHttpClientProtocol 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)
SoapVersion	Lekéri vagy beállítja a SOAP protokoll azon verzióját, amely a SOAP-kérést az XML-webszolgáltatáshoz küldi.
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, Object[], AsyncCallback, Object)	Elindítja egy XML-webszolgáltatás-metódus aszinkron meghívását a SOAP használatával.
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)
Discover()	Dinamikusan kapcsolódik egy XML-webszolgáltatáshoz, amelyet a felderítési dokumentumban a következő helyen ismertet: Url.
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)	Véget vet egy XML-webszolgáltatás-metódus aszinkron meghívásának a SOAP használatával.
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)
GetReaderForMessage(SoapClientMessage, Int32)	A paraméter tulajdonságával XmlReader Stream inicializált értéket ad SoapClientMessage vissza.
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 értéket WebRequest a megadotthoz `uri`.
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)
GetWriterForMessage(SoapClientMessage, Int32)	A paraméter tulajdonságával XmlWriter Stream inicializált értéket ad SoapClientMessage vissza.
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, Object[])	Egy XML Web Service-metódust hív meg szinkron módon a SOAP használatával.
InvokeAsync(String, Object[], SendOrPostCallback, Object)	A megadott metódust aszinkron módon hívja meg.
InvokeAsync(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

HttpSimpleClientProtocol

Visszajelzés

Hasznosnak találta ezt az oldalt?