Compartilhar via

FormErrorCollection.Add Método

  • Referência

Definição

Namespace:
Microsoft.Office.InfoPath
Assembly:
Microsoft.Office.InfoPath.dll

Sobrecargas

Add(XPathNavigator, String, String)

Cria e adiciona um novo FormError ao FormErrorCollection objeto associado ao formulário atual.
Add(XPathNavigator, String, String, String)

Cria e adiciona um novo FormError ao FormErrorCollection objeto associado ao formulário atual.
Add(XPathNavigator, String, String, String, Int32)

Cria e adiciona um novo FormError ao FormErrorCollection objeto associado ao formulário atual.
Add(XPathNavigator, String, String, String, Int32, ErrorMode)

Cria e adiciona um novo FormError ao FormErrorCollection objeto associado ao formulário atual.

Add(XPathNavigator, String, String)

Cria e adiciona um novo FormError ao FormErrorCollection objeto associado ao formulário atual.

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

Parâmetros

context
XPathNavigator

Um XPathNavigator objeto posicionado no nó ao qual o erro será associado.

name
String

O nome do erro (não pode estar em branco).

message
String

A mensagem curta para o erro.

Retornos

FormError

Uma referência ao novo FormError que foi adicionado à coleção.

Exceções

ArgumentNullException

Os parâmetros passados para esse método são uma referência nula (Nada no Visual Basic).

ArgumentException

Os parâmetros passados para esse método não são válidos. Por exemplo, eles são do tipo ou formato errado.

Exemplos

No exemplo a seguir, primeiro um objeto XPathNavigator é posicionado no campo com o qual associar um erro. Em seguida, o XPathNavigator, o nome e a mensagem são passados para o Add método da classe FormErrorCollection para adicionar o erro à coleção de erros do formulário.

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.")

Comentários

O FormErrorType do novo FormError será definido como UserDefined.

Observação: é possível adicionar vários erros com o mesmo name valor de parâmetro a nós diferentes context . No entanto, se você adicionar um erro com o mesmo nome ao mesmo context nó duas vezes, o segundo erro adicionado substituirá o primeiro.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.

Aplica-se a

Add(XPathNavigator, String, String, String)

Cria e adiciona um novo FormError ao FormErrorCollection objeto associado ao formulário atual.

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

Parâmetros

context
XPathNavigator

Um XPathNavigator objeto posicionado no nó ao qual o erro será associado.

name
String

O nome do erro (não pode estar em branco).

message
String

A mensagem curta para o erro.

messageDetails
String

A mensagem detalhada do erro.

Retornos

FormError

Uma referência ao novo FormError que foi adicionado à coleção.

Exceções

ArgumentException

Os parâmetros passados para esse método não são válidos. Por exemplo, eles são do tipo ou formato errado.

ArgumentNullException

Os parâmetros passados para esse método são uma referência nula (Nada no Visual Basic).

Exemplos

No exemplo a seguir, primeiro um objeto XPathNavigator é posicionado no campo com o qual associar um erro. Em seguida, a mensagem XPathNavigator, nome, mensagem e detalhada é passada para o Add método da classe FormErrorCollection para adicionar o erro à coleção de erros do formulário.

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)

Comentários

O FormErrorType do novo FormError será definido como UserDefined.

Observação: é possível adicionar vários erros com o mesmo name valor de parâmetro a nós diferentes context . No entanto, se você adicionar um erro com o mesmo nome ao mesmo context nó duas vezes, o segundo erro adicionado substituirá o primeiro.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.

Aplica-se a

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

Cria e adiciona um novo FormError ao FormErrorCollection objeto associado ao formulário atual.

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

Parâmetros

context
XPathNavigator

Um XPathNavigator objeto posicionado no nó ao qual o erro será associado.

name
String

O nome do erro (não pode estar em branco).

message
String

A mensagem curta para o erro.

messageDetails
String

A mensagem detalhada do erro.

errorCode
Int32

O código de erro do erro.

Retornos

FormError

Uma referência ao novo FormError que foi adicionado à coleção.

Exceções

ArgumentException

Os parâmetros passados para esse método não são válidos. Por exemplo, eles são do tipo ou formato errado.

ArgumentNullException

Os parâmetros passados para esse método são uma referência nula (Nada no Visual Basic).

Exemplos

No exemplo a seguir, primeiro um objeto XPathNavigator é posicionado no campo com o qual associar um erro. Em seguida, o XPathNavigator, nome, mensagem, mensagem detalhada, código de erro e número de erro são passados para o Add método da classe FormErrorCollection para adicionar o erro à coleção de erros do formulário.

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)

Comentários

O FormErrorType do novo FormError será definido como UserDefined.

Observação: é possível adicionar vários erros com o mesmo name valor de parâmetro a nós diferentes context . No entanto, se você adicionar um erro com o mesmo nome ao mesmo context nó duas vezes, o segundo erro adicionado substituirá o primeiro.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.

Aplica-se a

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

Cria e adiciona um novo FormError ao FormErrorCollection objeto associado ao formulário atual.

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

Parâmetros

context
XPathNavigator

Um XPathNavigator objeto posicionado no nó ao qual o erro será associado.

name
String

O nome do erro (não pode estar em branco).

message
String

A mensagem curta para o erro.

messageDetails
String

A mensagem detalhada do erro.

errorCode
Int32

O código de erro do erro.

errorMode
ErrorMode

Um ErrorMode que especifica o modo para exibir a mensagem de erro.

Retornos

FormError

Uma referência ao novo FormError que foi adicionado à coleção.

Exceções

ArgumentException

Os parâmetros passados para esse método não são válidos. Por exemplo, eles são do tipo ou formato errado.

ArgumentNullException

Os parâmetros passados para esse método são uma referência nula (Nada no Visual Basic).

Exemplos

No exemplo a seguir, primeiro um objeto XPathNavigator é posicionado no campo com o qual associar um erro. Em seguida, o modo XPathNavigator, nome, mensagem, mensagem detalhada, código de erro, número de erro e modo de exibição de erro são passados para o Add método da classe FormErrorCollection para adicionar o erro à coleção de erros do formulário.

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)

Comentários

O FormErrorType do novo FormError será definido como UserDefined.

Observação: é possível adicionar vários erros com o mesmo name valor de parâmetro a nós diferentes context . No entanto, se você adicionar um erro com o mesmo nome ao mesmo context nó duas vezes, o segundo erro adicionado substituirá o primeiro.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.

Aplica-se a