FormErrorCollection.Add Метод (XPathNavigator, String, String)

Статья
04/27/2010

Создает и добавляет новый объект FormError к объекту FormErrorCollection, связанному с текущей формой.

Пространство имен: Microsoft.Office.InfoPath
Сборка: Microsoft.Office.InfoPath (в microsoft.office.infopath.dll)

Синтаксис

'Декларация
Public MustOverride Function Add ( _
    context As XPathNavigator, _
    name As String, _
    message As String _
) As FormError
'Применение
Dim instance As FormErrorCollection
Dim context As XPathNavigator
Dim name As String
Dim message As String
Dim returnValue As FormError

returnValue = instance.Add(context, name, message)

public abstract FormError Add (
    XPathNavigator context,
    string name,
    string message
)

Параметры

context
Объект XPathNavigator, расположенный в узле, с которым будет связана ошибка.

name
Имя ошибки (не может быть пустым).

message
Сокращенное сообщение об ошибке.

Возвращаемое значение

Ссылка на новый объект FormError, который был добавлен к коллекции.

Исключения

Тип исключения	Условие
ArgumentNullException	Этому методу переданы параметры .
ArgumentException	Этому методу переданы недопустимые параметры . Например, неправильный тип или формат.

Заметки

Свойству FormErrorType нового объекта FormError будет задан параметр UserDefined.

Заметка
Можно добавить несколько ошибок с тем же значение параметра name к разным узлам context. Однако если ошибка с тем же именем дважды добавляется к одному и тому же узлу context вторая добавленная ошибка перезаписывает первую.

Доступ к этому члену имеется только у форм, запускаемых на том же домене, что и открытая в настоящий момент форма, или у форм, которым были присвоены междоменные разрешения.

Доступ к этому типу или члену имеется из программы, работающей в формах, открытых в Microsoft Office InfoPath 2007 или в веб-обозревателе.

Пример

В следующем примере первый объект XPathNavigator размещен в поле, с которым нужно связать ошибку. Затем XPathNavigator, имя и сообщение передаются методу Add класса FormErrorCollection, чтобы добавить ошибку к коллекции ошибок формы.

XPathNavigator root, txtbox;
// Create XPathNavigator for main data source.
root = this.MainDataSource.CreateNavigator();

// Create XPathNavigator positioned at field to associate with error.
txtbox = root.SelectSingleNode("//my:field1", this.NamespaceManager);

// Get form's collection of errors and add error.
this.Errors.Add(txtbox, "Field1Error", "Short error message.");

Dim root, txtbox As XPathNavigator
' Create XPathNavigator for main data source.
root = Me.MainDataSource.CreateNavigator()

' Create XPathNavigator positioned at field to add error.
txtbox = root.SelectSingleNode("//my:field1", Me.NamespaceManager)

' Get form's collection of errors and add error.
Me.Errors.Add(txtbox, "Field1Error", "Short error message.")

См. также

Ссылка

Класс FormErrorCollection
Члены FormErrorCollection
Пространство имен Microsoft.Office.InfoPath

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