SoapHttpClientProtocol Třída
Definice
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í.
Určuje klienta třídy, ze kterého jsou odvozeny proxy servery při použití protokolu SOAP.
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
- Dědičnost
- Atributy
Příklady
Následující příklad kódu je třída proxy generovaná Wsdl.exe pro Math
webovou službu XML. Třída proxy je odvozena z SoapHttpClientProtocoltřídy , která je odvozena z abstraktní WebClientProtocol 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;
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
Následující příklad kódu je Math
webová služba XML, ze které byla vygenerována předchozí třída proxy.
Důležité
Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřte, že uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.
<%@ 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
Poznámky
Pokud vytváříte klienta webové služby XML, musí být pro webovou službu XML vytvořena třída proxy, která je odvozena nepřímo nebo přímo z WebClientProtocol . Při volání klienta webové služby XML pomocí protokolu SOAP musí být třída proxy odvozena z SoapHttpClientProtocol, který je odvozen z HttpWebClientProtocol. HttpWebClientProtocolje zase odvozeno z WebClientProtocol.
Chcete-li komunikovat s webovou službou XML, vytvořte třídu proxy, která je odvozena nepřímo nebo přímo z WebClientProtocol webové služby XML, kterou chcete volat. Místo ručního vytváření třídy proxy použijte nástroj Web Services Description Language (Wsdl.exe) k vytvoření třídy proxy pro popis dané webové služby XML. Když je pro protokol SOAP generována třída proxy, synchronní volání metod webové služby XML se provádí prostřednictvím Invoke metody , zatímco asynchronní volání jsou provedena pomocí BeginInvoke metody a EndInvoke metody .
Poznámky pro dědice
Při přepsání této třídy můžete zavést metody v odvozené třídě, které jsou specifické pro konkrétní typ webové služby XML. Metody zachycují parametry a volají základní třídu pro práci při komunikaci s webovou službou XML. Pokud jsou zavedené metody asynchronní, zavolejte metodu BeginInvoke(String, Object[], AsyncCallback, Object) a metodu EndInvoke(IAsyncResult) . Pokud jsou zavedené metody synchronní, zavolejte metodu Invoke(String, Object[]) . Přepsaný konstruktor obvykle nastaví Url vlastnost na adresu URL metody webové služby XML.
Konstruktory
SoapHttpClientProtocol() |
Inicializuje novou instanci SoapHttpClientProtocol 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í pověření 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 tuto HttpWebClientProtocolfunkci 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 předběžné ověřování je povoleno. (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 provedení požadavku klienta na webovou službu XML. (Zděděno od WebClientProtocol) |
Site |
Získá nebo nastaví ISite z Component. (Zděděno od Component) |
SoapVersion |
Získá nebo nastaví verzi protokolu SOAP použitý k provedení požadavku SOAP webové služby XML. |
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 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á se odešle s každou žádostí. (Zděděno od HttpWebClientProtocol) |
Metody
Abort() |
Zruší požadavek na metodu webové služby XML. (Zděděno od WebClientProtocol) |
BeginInvoke(String, Object[], AsyncCallback, Object) |
Spustí asynchronní vyvolání metody webové služby XML pomocí protokolu SOAP. |
CancelAsync(Object) |
Zruší asynchronní volání metody webové služby XML, pokud 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 sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject) |
Discover() |
Dynamicky vytvoří vazbu na webovou službu XML popsanou v dokumentu zjišťování na adrese Url. |
Dispose() |
Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component) |
Dispose(Boolean) |
Uvolní nespravované prostředky používané nástrojem Component a volitelně uvolní spravované prostředky. (Zděděno od Component) |
EndInvoke(IAsyncResult) |
Ukončí asynchronní vyvolání metody webové služby XML pomocí protokolu SOAP. |
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 aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
GetReaderForMessage(SoapClientMessage, Int32) |
Vrátí inicializovaný XmlReader s Stream vlastností parametru SoapClientMessage . |
GetService(Type) |
Vrátí objekt, který představuje službu poskytovanou objektem Component nebo .Container (Zděděno od Component) |
GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
GetWebRequest(Uri) |
Vytvoří pro WebRequest zadaný |
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) |
GetWriterForMessage(SoapClientMessage, Int32) |
XmlWriter Vrátí inicializovaný s Stream vlastností parametru SoapClientMessage . |
InitializeLifetimeService() |
Zastaralé.
Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
Invoke(String, Object[]) |
Vyvolá metodu webové služby XML synchronně pomocí protokolu SOAP. |
InvokeAsync(String, Object[], SendOrPostCallback) |
Vyvolá zadanou metodu asynchronně. |
InvokeAsync(String, Object[], SendOrPostCallback, Object) |
Vyvolá zadanou metodu asynchronně. |
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 , Componentpokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component) |
Událost
Disposed |
Vyvolá se, když je komponenta uvolněna voláním Dispose() metody . (Zděděno od Component) |
Platí pro
Bezpečný přístup z více vláken
Tento typ je bezpečný pro přístup z více vláken.