SharePointListRWQueryConnection 클래스

SharePoint 목록 또는 문서 라이브러리에서 데이터를 검색하는 데 사용할 데이터 연결을 나타냅니다.

상속 계층 구조

System.Object
  Microsoft.Office.InfoPath.DataConnection
    Microsoft.Office.InfoPath.SharePointListRWQueryConnection

네임스페이스:  Microsoft.Office.InfoPath
어셈블리:  Microsoft.Office.InfoPath(Microsoft.Office.InfoPath.dll)

구문

‘선언
Public MustInherit Class SharePointListRWQueryConnection _
    Inherits DataConnection
‘사용 방법
Dim instance As SharePointListRWQueryConnection
public abstract class SharePointListRWQueryConnection : DataConnection

주의

SharePointListRWQueryConnection 클래스는 InfoPath에서 만든 보조 데이터 연결을 나타내며, 이 데이터 연결은 SharePoint 목록 또는 문서 라이브러리에서 데이터를 검색하기 위해 필요한 모든 정보를 지정합니다. SharePoint 목록 또는 문서 라이브러리에 대한 보조 데이터 연결을 포함하는 양식 서식 파일을 만들려면 데이터 탭에서 데이터 연결 명령을 사용합니다.

참고 사항참고 사항

SharePointListRWQueryConnection 클래스의 멤버를 사용하여 작성된 코드는 InfoPath 2003 또는 InfoPath 2007에서 만든 SharePoint 목록 또는 문서 라이브러리에 대한 데이터 연결, InfoPath 2007 양식 서식 파일 중 하나를 사용하여 InfoPath 2010에서 만든 새 양식 서식 파일의 데이터 연결 또는 데이터 연결 대화 상자의 이전 버전으로 변환 단추를 사용하여 변환한 데이터 연결과 호환되지 않습니다. InfoPath의 이전 버전과 호환성을 유지할 필요가 없고 SharePointListRWQueryConnection 클래스의 멤버를 사용하여 코드를 작성하려는 경우에는 데이터 연결 대화 상자의 현재 버전으로 변환 단추를 사용하여 데이터 연결을 변환합니다.

참고 사항참고 사항

SharePoint 목록 서식 파일을 사용하여 새 양식 서식 파일을 만드는 방법으로 SharePoint 목록에 대한 기본 데이터 연결을 만들 수 있습니다. 그러나 SharePoint 목록 서식 파일을 사용하여 만든 양식 서식 파일에서는 규칙과 같은 선언적 논리만 지원되므로 이러한 양식에 숨어 있는 양식 코드를 작성할 수 없습니다. 따라서 SharePoint 목록에 대한 기본 데이터 연결로 작업하기 위해 SharePointListRWQueryConnection 클래스와 해당 멤버를 사용할 수 없습니다.

SharePointListRWQueryConnection 클래스는 데이터 연결의 이름 및 연결을 통해 데이터를 검색할 SharePoint Foundation 또는 Microsoft SharePoint Server 사이트의 목록 또는 문서 라이브러리에 대한 URL을 가져오는 데 사용할 수 있는 속성을 제공합니다.

데이터 연결과 연결된 SharePointListRWQueryConnection 개체는 XmlForm 클래스의 DataConnections 속성을 사용하여 액세스할 수 있으며, 이를 통해 양식 서식 파일의 DataConnectionCollection로부터의 연결이 반환됩니다.

DataConnection 기본 클래스에서 상속된 기본 Execute 메서드는 디자인 타임에 InfoPath 양식 서식 파일에서 선언적으로 정의된 값을 사용하여 쿼리 또는 전송 작업을 수행합니다. 또한 SharePointListRWQueryConnection 클래스는 반환되는 데이터를 삽입할 다른 위치를 지정할 수 있는 Execute(XPathNavigator) 메서드를 제공합니다.

다음 코드 예제에서 SharePoint 사이트의 연락처 정보 목록에 연결되는 "Contacts"라는 데이터 연결은 다음과 같은 2단계 과정을 통해 액세스됩니다. 먼저 해당 데이터 연결을 나타내는 개체를 검색하기 위해 "Contacts"라는 이름이 DataConnectionCollection 클래스의 Item 속성에 전달됩니다. 그런 다음 컬렉션에서 반환된 개체가 SharePointListRWQueryConnection 형식으로 캐스팅됩니다.

SharePointListRWQueryConnection spConnection = (SharePointListRWQueryConnection)this.DataConnections["Contacts"];
Dim spConnection As SharePointListRWQueryConnection = _
   DirectCast(Me.DataConnections("Contacts"), _
   SharePointListRWQueryConnection)

데이터 연결에 대한 참조를 설정한 후에는 SharePointListRWQueryConnection 개체의 속성 또는 메서드를 사용할 수 있습니다. 다음 코드 예제에서는 문자열 변수를 DataConnection 기본 클래스에서 상속된 Name 속성에서 반환하는 값으로 설정합니다.

string spName = spConnection.Name;
Dim spName As String = spConnection.Name

스레드 보안

이 형식의 모든 공용 static (Visual Basic의Shared ) 멤버는 스레드로부터 안전합니다. 모든 인스턴스 멤버는 스레드로부터 안전하지 않을 수도 있습니다.

참고 항목

참조

SharePointListRWQueryConnection 멤버

Microsoft.Office.InfoPath 네임스페이스