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

A HTTP-GET protokollt használó XML Web Service-ügyfélproxyk alaposztálya.

public ref class HttpGetClientProtocol : System::Web::Services::Protocols::HttpSimpleClientProtocol

public class HttpGetClientProtocol : System.Web.Services.Protocols.HttpSimpleClientProtocol

type HttpGetClientProtocol = class
    inherit HttpSimpleClientProtocol

Public Class HttpGetClientProtocol
Inherits HttpSimpleClientProtocol

Öröklődés: Object

MarshalByRefObject

Component

WebClientProtocol

HttpWebClientProtocol

HttpSimpleClientProtocol
HttpGetClientProtocol

Példák

Az alábbi példa egy proxyosztály, amelyet az alábbi XML-webszolgáltatás Wsdl.exe Math 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

Az alábbi példa az Math XML-webszolgáltatás, amelyből a fenti proxyosztály létrejött.

<%@ WebService Language="C#" Class="Math"%>
 using System.Web.Services;
 using System;
 
 public class Math {
      [ WebMethod ]
      public int Add(int num1, int num2) {
          return num1+num2;
          }
 }

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

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

Megjegyzések

Ha egy XML-webszolgáltatás-ügyfél a HTTP-GET protokollt használja, a paraméterek az URL-címen belül lesznek kódolva, és a válasz egyszerű XML-ben lesz visszaadva.

Ha xml webszolgáltatás-ügyfelet hoz létre ASP.NET használatával, akkor a meghívni kívánt XML-webszolgáltatáshoz létre kell hozni egy közvetett vagy közvetlenül a WebClientProtocol-ból származó proxyosztályt. Amikor az XML Web Service-ügyfél HTTP használatával hívja meg az XML-webszolgáltatást, a proxyosztályt a következőből HttpSimpleClientProtocol WebClientProtocolszármaztathatja.

HttpGetClientProtocol és HttpPostClientProtocol abból HttpSimpleClientProtocolszármazik, amely támogatja egy XML-webszolgáltatás-metódus meghívását a HTTP-GET és HTTP-POST protokollok használatával. A SOAP használatával XML-webszolgáltatást hívó ügyfeleknek a következőből SoapHttpClientProtocolkell származnia: .

A proxyosztályok létrehozásával kapcsolatos részletekért lásd: XML webszolgáltatás-proxy létrehozása.

Konstruktorok

Name	Description
HttpGetClientProtocol()	Inicializálja a HttpGetClientProtocol 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. (Öröklődés forrása HttpSimpleClientProtocol)
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. (Öröklődés forrása HttpSimpleClientProtocol)
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 példányt WebRequest a megadott URI-hoz.
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. (Öröklődés forrása HttpSimpleClientProtocol)
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. (Öröklődés forrása HttpSimpleClientProtocol)
InvokeAsync(String, String, Object[], SendOrPostCallback)	A megadott metódust aszinkron módon hívja meg. (Öröklődés forrása HttpSimpleClientProtocol)
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:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?