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

FormErrorCollection.Add Метод

  • Ссылка

Определение

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

Перегрузки

Add(XPathNavigator, String, String)

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

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

Создает и добавляет новый FormError объект, связанный FormErrorCollection с текущей формой.
Add(XPathNavigator, String, String, String, Int32, ErrorMode)

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

Add(XPathNavigator, String, String)

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

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message);
public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message);
abstract member Add : System.Xml.XPath.XPathNavigator * string * string -> Microsoft.Office.InfoPath.FormError
Public MustOverride Function Add (context As XPathNavigator, name As String, message As String) As FormError

Параметры

context
XPathNavigator

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

name
String

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

message
String

Краткое сообщение об ошибке.

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

FormError

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

Исключения

ArgumentNullException

Параметры, передаваемые этому методу, являются пустой ссылкой (Nothing в Visual Basic).

ArgumentException

Этому методу переданы недопустимые параметры. Например, неправильный тип или формат.

Примеры

В следующем примере первый объект 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.")

Комментарии

Для FormErrorType нового объекта FormError будет задано значение UserDefined.

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

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

Доступ к этому типу или элементу предоставляется только из кода, выполняющегося в формах, открытых в Microsoft InfoPath Filler или браузере.

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

Add(XPathNavigator, String, String, String)

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

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails);
public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails);
abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string -> Microsoft.Office.InfoPath.FormError
Public MustOverride Function Add (context As XPathNavigator, name As String, message As String, messageDetails As String) As FormError

Параметры

context
XPathNavigator

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

name
String

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

message
String

Краткое сообщение об ошибке.

messageDetails
String

Подробное сообщение об ошибке.

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

FormError

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

Исключения

ArgumentException

Этому методу переданы недопустимые параметры. Например, неправильный тип или формат.

ArgumentNullException

Параметры, передаваемые этому методу, являются пустой ссылкой (Nothing в Visual Basic).

Примеры

В следующем примере первый объект 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.", 
   "Detailed error description.", 102057, ErrorMode.Modeless);

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.", 
   "Detailed error description.", 102057, ErrorMode.Modeless)

Комментарии

Для FormErrorType нового объекта FormError будет задано значение UserDefined.

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

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

Доступ к этому типу или элементу предоставляется только из кода, выполняющегося в формах, открытых в Microsoft InfoPath Filler или браузере.

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

Add(XPathNavigator, String, String, String, Int32)

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

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails, int errorCode);
public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails, int errorCode);
abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string * int -> Microsoft.Office.InfoPath.FormError
Public MustOverride Function Add (context As XPathNavigator, name As String, message As String, messageDetails As String, errorCode As Integer) As FormError

Параметры

context
XPathNavigator

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

name
String

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

message
String

Краткое сообщение об ошибке.

messageDetails
String

Подробное сообщение об ошибке.

errorCode
Int32

Код ошибки.

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

FormError

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

Исключения

ArgumentException

Этому методу переданы недопустимые параметры. Например, неправильный тип или формат.

ArgumentNullException

Параметры, передаваемые этому методу, являются пустой ссылкой (Nothing в Visual Basic).

Примеры

В следующем примере первый объект 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.", 
   "Detailed error description.", 102057);

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.", 
   "Detailed error description.", 102057)

Комментарии

Для FormErrorType нового объекта FormError будет задано значение UserDefined.

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

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

Доступ к этому типу или элементу предоставляется только из кода, выполняющегося в формах, открытых в Microsoft InfoPath Filler или браузере.

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

Add(XPathNavigator, String, String, String, Int32, ErrorMode)

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

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails, int errorCode, Microsoft::Office::InfoPath::ErrorMode errorMode);
public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails, int errorCode, Microsoft.Office.InfoPath.ErrorMode errorMode);
abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string * int * Microsoft.Office.InfoPath.ErrorMode -> Microsoft.Office.InfoPath.FormError

Параметры

context
XPathNavigator

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

name
String

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

message
String

Краткое сообщение об ошибке.

messageDetails
String

Подробное сообщение об ошибке.

errorCode
Int32

Код ошибки.

errorMode
ErrorMode

Объект ErrorMode , указывающий режим отображения сообщения об ошибке.

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

FormError

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

Исключения

ArgumentException

Этому методу переданы недопустимые параметры . Например, неправильный тип или формат.

ArgumentNullException

Параметры, передаваемые этому методу, являются пустой ссылкой (Nothing в Visual Basic).

Примеры

В следующем примере первый объект 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.", 
   "Detailed error description.", 102057, ErrorMode.Modeless);

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.", 
   "Detailed error description.", 102057, ErrorMode.Modeless)

Комментарии

Для FormErrorType нового объекта FormError будет задано значение UserDefined.

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

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

Доступ к этому типу или элементу предоставляется только из кода, выполняющегося в формах, открытых в Microsoft InfoPath Filler или браузере.

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