WebServiceConnection 클래스
XML 웹 서비스 연결을 나타냅니다.
상속 계층 구조
System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.WebServiceConnection
네임스페이스: Microsoft.Office.InfoPath
어셈블리: Microsoft.Office.InfoPath(Microsoft.Office.InfoPath.dll)
구문
‘선언
Public MustInherit Class WebServiceConnection _
Inherits DataConnection
‘사용 방법
Dim instance As WebServiceConnection
public abstract class WebServiceConnection : DataConnection
주의
WebServiceConnection 클래스는 웹 서비스를 사용하여 외부 데이터 원본에서 데이터를 검색하거나 외부 데이터 원본에 데이터를 전송하는 데 필요한 모든 정보를 지정하는 InfoPath 데이터 연결 마법사를 사용하여 만든 데이터 연결을 나타냅니다.
WebServiceConnection은 데이터 연결의 입력 및 작업 문자열에 대한 정보를 가져오거나 설정하는 데 사용할 수 있는 속성과 XML 웹 서비스의 WSDL(Web Services Description Language) 파일에 대한 URL(Uniform Resource Locator)을 가져오는 데 사용할 수 있는 속성을 제공합니다.
데이터 연결과 관련된 WebServiceConnection 개체는 양식 서식 파일의 DataConnectionCollection에서 연결을 반환하기 위해 XmlForm 클래스의 DataConnections 속성을 사용하여 액세스할 수 있습니다.
WebServiceConnection 클래스는 InfoPath 양식 서식 파일 디자인 모드에서 선언적으로 정의된 값을 사용하여 쿼리 또는 전송 작업을 실행하는 기본 Execute 메서드(DataConnection 기본 클래스에서 상속됨)뿐만 아니라 전송할 다른 데이터 원본, 반환된 데이터를 삽입할 다른 위치, 연결에서 반환되는 오류를 검색하는 방법 등을 지정할 수 있도록 WebServiceConnection.Execute 메서드도 제공합니다.
WebServiceConnection 클래스는 Microsoft Office InfoPath 2003 개체 모델의 WebServiceAdapterObject 인터페이스에 해당합니다.
예
다음 예제에서는 DataConnectionCollection 클래스의 Item 속성에 이름을 전달한 후 반환된 개체를 WebServiceConnection 형식으로 캐스팅하여 "Main query"라는 연결을 나타내는 WebServiceConnection 개체에 대한 참조를 설정합니다.
WebServiceConnection wsConnection = (WebServiceConnection)this.DataConnections["Main query"];
Dim wsConnection As WebServiceConnection = _
DirectCast(Me.DataConnections("Main query"), WebServiceConnection)
WebServiceConnection 개체에 대한 참조를 설정한 후에는 다음 예제와 같이 이 개체의 속성을 사용하여 string 변수를 ServiceUrl 속성에서 반환하는 값으로 설정할 수 있습니다.
string wsServiceURL = wsConnection.ServiceUrl.ToString();
Dim wsServiceURL As String = _
string wsServiceURL = wsConnection.ServiceUrl.ToString()
스레드 보안
이 형식의 모든 공용 static (Visual Basic의Shared ) 멤버는 스레드로부터 안전합니다. 모든 인스턴스 멤버는 스레드로부터 안전하지 않을 수도 있습니다.