HttpGetClientProtocol Třída

Reference

Definice

Obor názvů:: System.Web.Services.Protocols

Sestavení:: System.Web.Services.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Základní třída pro proxy klientů webové služby XML, které používají protokol HTTP-GET.

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

Dědičnost: Object

MarshalByRefObject

Component

WebClientProtocol

HttpWebClientProtocol

HttpSimpleClientProtocol
HttpGetClientProtocol

Příklady

Následující příklad je třída proxy vygenerovaná Wsdl.exe pro níže uvedené Math webové služby XML. Třída proxy je odvozena od HttpGetClientProtocoltřídy , která je odvozena z abstraktní HttpSimpleClientProtocol třídy.

#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

Následující příklad je Math webová služba XML, ze které byla vytvořena výše uvedená třída proxy.

<%@ 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

Poznámky

Když klient webové služby XML používá protokol HTTP-GET, parametry jsou kódovány v rámci adresy URL a odpověď je vrácena ve formátu prostého XML.

Pokud vytváříte klienta webové služby XML pomocí ASP.NET, je nutné vytvořit třídu proxy serveru odvozenou nepřímo nebo přímo z WebClientProtocol webové služby XML, kterou chcete volat. Když klient webové služby XML volá webovou službu XML pomocí protokolu HTTP, odvozujte třídu proxy z HttpSimpleClientProtocol, který zase odvozuje z WebClientProtocol.

HttpGetClientProtocol a HttpPostClientProtocol jsou odvozeny od HttpSimpleClientProtocol, poskytující podporu pro volání metody webové služby XML pomocí protokolů HTTP-GET a HTTP-POST v uvedeném pořadí. Klienti volající webovou službu XML pomocí protokolu SOAP by měli odvodit z SoapHttpClientProtocol.

Podrobnosti o vytvoření třídy proxy najdete v tématu Vytvoření proxy webové služby XML.

Konstruktory

HttpGetClientProtocol()

Inicializuje novou instanci HttpGetClientProtocol třídy.

Vlastnosti

AllowAutoRedirect	Získá nebo nastaví, zda klient automaticky sleduje přesměrování serveru. (Zděděno od HttpWebClientProtocol)
CanRaiseEvents	Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
ClientCertificates	Získá kolekci klientských certifikátů. (Zděděno od HttpWebClientProtocol)
ConnectionGroupName	Získá nebo nastaví název skupiny připojení pro požadavek. (Zděděno od WebClientProtocol)
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
CookieContainer	Získá nebo nastaví kolekci souborů cookie. (Zděděno od HttpWebClientProtocol)
Credentials	Získá nebo nastaví přihlašovací údaje zabezpečení pro ověřování klienta webové služby XML. (Zděděno od WebClientProtocol)
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
EnableDecompression	Získá nebo nastaví hodnotu, která označuje, zda je pro tento HttpWebClientProtocolobjekt povolena dekomprese. (Zděděno od HttpWebClientProtocol)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
PreAuthenticate	Získá nebo nastaví, zda je povolené předběžné ověřování. (Zděděno od WebClientProtocol)
Proxy	Získá nebo nastaví informace proxy pro vytvoření požadavku webové služby XML přes bránu firewall. (Zděděno od HttpWebClientProtocol)
RequestEncoding	Slouží Encoding k vytvoření požadavku klienta na webovou službu XML. (Zděděno od WebClientProtocol)
Site	Získá nebo nastaví ISite hodnotu Component. (Zděděno od Component)
Timeout	Označuje čas, kdy klient webové služby XML čeká na odpověď na synchronní požadavek webové služby XML (v milisekundách). (Zděděno od WebClientProtocol)
UnsafeAuthenticatedConnectionSharing	Získá nebo nastaví hodnotu, která označuje, zda sdílení připojení je povoleno, když klient používá ověřování NTLM pro připojení k webovému serveru, který je hostitelem webové služby XML. (Zděděno od HttpWebClientProtocol)
Url	Získá nebo nastaví základní adresu URL webové služby XML, který klient požaduje. (Zděděno od WebClientProtocol)
UseDefaultCredentials	Získá nebo nastaví hodnotu, která označuje, zda nastavit Credentials vlastnost na hodnotu DefaultCredentials vlastnosti. (Zděděno od WebClientProtocol)
UserAgent	Získá nebo nastaví hodnotu pro hlavičku uživatelského agenta, která je odeslána s jednotlivými požadavky. (Zděděno od HttpWebClientProtocol)

Metody

Abort()	Zruší požadavek na metodu webové služby XML. (Zděděno od WebClientProtocol)
BeginInvoke(String, String, Object[], AsyncCallback, Object)	Spustí asynchronní vyvolání metody webové služby XML. (Zděděno od HttpSimpleClientProtocol)
CancelAsync(Object)	Zruší asynchronní volání metody webové služby XML, pokud je volání již dokončeno. (Zděděno od HttpWebClientProtocol)
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané Component nástrojem a volitelně uvolní spravované prostředky. (Zděděno od Component)
EndInvoke(IAsyncResult)	Dokončí asynchronní vyvolání metody webové služby XML pomocí protokolu HTTP. (Zděděno od HttpSimpleClientProtocol)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jejím Containerobjektem . (Zděděno od Component)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
GetWebRequest(Uri)	Vytvoří WebRequest instanci pro zadaný identifikátor URI.
GetWebResponse(WebRequest)	Vrátí odpověď ze synchronního požadavku na metodu webové služby XML. (Zděděno od HttpWebClientProtocol)
GetWebResponse(WebRequest, IAsyncResult)	Vrátí odpověď z asynchronního požadavku na metodu webové služby XML. (Zděděno od HttpWebClientProtocol)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
Invoke(String, String, Object[])	Vyvolá metodu webové služby XML pomocí protokolu HTTP. (Zděděno od HttpSimpleClientProtocol)
InvokeAsync(String, String, Object[], SendOrPostCallback)	Vyvolá zadanou metodu asynchronně. (Zděděno od HttpSimpleClientProtocol)
InvokeAsync(String, String, Object[], SendOrPostCallback, Object)	Vyvolá zadanou metodu asynchronně při zachování přidruženého stavu. (Zděděno od HttpSimpleClientProtocol)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
ToString()	String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)

Událost

Disposed

Nastane, když je komponenta odstraněna voláním Dispose() metody.

(Zděděno od Component)

Platí pro

Sdílet prostřednictvím