SharePointListRWQueryConnection Класс

Ссылка

Определение

Пространство имен:: Microsoft.Office.InfoPath

Сборка:: Microsoft.Office.InfoPath.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет подключение к данным для извлечения данных из списка SharePoint или библиотеки документов.

public ref class SharePointListRWQueryConnection abstract : Microsoft::Office::InfoPath::DataConnection

public abstract class SharePointListRWQueryConnection : Microsoft.Office.InfoPath.DataConnection

type SharePointListRWQueryConnection = class
    inherit DataConnection

Public MustInherit Class SharePointListRWQueryConnection
Inherits DataConnection

Наследование: Object

DataConnection
SharePointListRWQueryConnection

Примеры

В следующем примере кода показано, как благодаря процессу, состоящему из двух шагов, образуется доступ к подключению к данным "Contacts", подключающемуся к списку контактной информации на странице SharePoint. Имя Contacts передается свойству Item[String]DataConnectionCollection класса для получения объекта, представляющего подключение к данным. Затем объект, возвращенный из коллекции, приводится к типу SharePointListRWQueryConnection .

SharePointListRWQueryConnection spConnection = (SharePointListRWQueryConnection)this.DataConnections["Contacts"];

Dim spConnection As SharePointListRWQueryConnection = _
   DirectCast(Me.DataConnections("Contacts"), _
   SharePointListRWQueryConnection)

После установки ссылки на подключение к данным можно использовать свойства или методы SharePointListRWQueryConnection объекта . В следующем примере кода строковая переменная задает значение, возвращаемое свойством, Name унаследованным от DataConnection базового класса.

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

Класс SharePointListRWQueryConnection представляет дополнительное подключение к данным, созданное в InfoPath, которое указывает все сведения, необходимые для получения данных из списка Или библиотеки документов SharePoint. Для создания шаблона формы, содержащего вспомогательное подключение к данным для списка SharePoint или библиотеки документов используйте команду Подключения к данным на вкладке Данные.

Примечание. Код, написанный SharePointListRWQueryConnection с помощью членов класса, несовместим с подключением к данным к списку Или библиотеке документов SharePoint, созданной в InfoPath 2003 или InfoPath 2007, с подключением к данным в новом шаблоне формы, созданном в InfoPath с одним из шаблонов форм InfoPath 2007, или с подключением к данным, преобразованным с помощью кнопки Преобразовать в предыдущую версию в диалоговом окне Connections данных. Если вам не нужно поддерживать совместимость с более ранней версией InfoPath и вы хотите писать код с членами SharePointListRWQueryConnection класса, преобразуйте подключение к данным с помощью кнопки Преобразовать в текущую версию в диалоговом окне Connections данных.

Примечание. Вы можете создать основное подключение к данным (main) к списку SharePoint, создав новый шаблон формы с помощью шаблона списка SharePoint. Однако в подобной форме невозможно написать код формы, поскольку в шаблоне формы, созданном с помощью шаблона Список SharePoint, поддерживается только описательная логика, как например правила. По этой причине нельзя использовать SharePointListRWQueryConnection класс и его члены для работы с основным подключением данных к списку SharePoint.

Класс SharePointListRWQueryConnection предоставляет свойства, которые можно использовать для получения имени подключения к данным и URL-адреса списка или библиотеки документов на сайте SharePoint Foundation или Microsoft SharePoint Server, с которого подключение извлекает данные.

Объект SharePointListRWQueryConnection , связанный с подключением данных, доступен с помощью DataConnections свойства XmlForm класса для возврата соединения из DataConnectionCollection шаблона формы.

Метод по умолчанию Execute() , унаследованный от DataConnection базового класса, выполняет запрос или операцию отправки, используя значения, декларативно определенные в шаблоне формы InfoPath во время разработки. Кроме того, SharePointListRWQueryConnection класс предоставляет Execute(XPathNavigator) метод , который позволяет указать другое расположение для вставки возвращаемых данных.

Конструкторы

SharePointListRWQueryConnection()

Представляет подключение к данным для извлечения данных из списка SharePoint или библиотеки документов.

Свойства

ContentTypeId	Возвращает или задает идентификатор типа контента списка SharePoint, связанного SharePointListRWQueryConnection с объектом .
ListId	Возвращает или задает идентификатор списка SharePoint, связанного SharePointListRWQueryConnection с объектом .
Name	Возвращает имя подключения данных. (Унаследовано от DataConnection)
SiteUrl	Возвращает или задает Uri объект , представляющий URL-адрес сайта SharePoint Foundation, связанного Microsoft.Office.InfoPath.SharepointListRWQueryConnection с объектом .

Методы

Execute()

В зависимости от класса ConnectionTypeConnection, из которого осуществляется вызов, выполняет операцию отправки или запроса в подключение данных с помощью декларативно определенных значений для отправляемых данных, параметров запроса или извлекаемых данных.

(Унаследовано от DataConnection)

Execute(XPathNavigator)

Переопределяет метод по умолчанию Execute() , чтобы включить указание другого расположения для вставки возвращаемых данных.

Применяется к

Поделиться через