FormEvents.Submit Событие

Определение

Пространство имен:

Microsoft.Office.InfoPath

Сборка:

Microsoft.Office.InfoPath.dll

Происходит при использовании команды Submit из пользовательского интерфейса или Submit() при использовании метода .

public:
 abstract event Microsoft::Office::InfoPath::SubmitEventHandler ^ Submit;

public abstract event Microsoft.Office.InfoPath.SubmitEventHandler Submit;

member this.Submit : Microsoft.Office.InfoPath.SubmitEventHandler 

Public MustOverride Custom Event Submit As SubmitEventHandler 

Тип события

SubmitEventHandler

Исключения

InvalidOperationException

Попытка разработчика привязать событие в другом местоположении, чем метод InternalStartup.

Примеры

В следующем примере обработчик события используется для Submit предотвращения отправки формы, если форма не была сохранена.

public void FormEvents_Submit(object sender, SubmitEventArgs e)
{
   if(this.Dirty || this.New)
      MessageBox.Show("Please save this form before submitting it.");
      e.CancelableArgs.Cancel = true;
   else
      e.CancelableArgs.Message = "Submit succeeded.";
}

Public Sub FormEvents_Submit(ByVal sender As Object, _
   ByVal e As SubmitEventArgs)
   If(Me.Dirty Or Me.New) Then
      MessageBox.Show("Please save this form before submitting it.")
      e.CancelableArgs.Cancel = True
   Else
      e.CancelableArgs.Message = "Submit succeeded."
   End If
End Sub

Комментарии

Важно! Событие Submit не предназначено для создания экземпляра разработчиком в коде формы. Следует добавлять обработчики событий только для событий уровня формы из пользовательского интерфейса режима разработки Microsoft InfoPath. При добавлении обработчика событий в шаблон формы из пользовательского интерфейса режима конструктора InfoPath создает код в методе InternalStartup файла кода формы с помощью EventManager класса и члена класса для привязки FormEvents события к его обработчику событий. Сведения о порядке добавления обработчиков событий в режиме конструктора InfoPath см. в разделе How to: Add an Event Handler.

Событие Submit возникает только в том случае, если шаблон формы имеет параметр Выполнить пользовательское действие с помощью кода, заданный в диалоговом окне "Параметры отправки".

Событие Submit связывается с помощью делегата SubmitEventHandler .

Событие Submit можно отменить с помощью CancelableArgs свойства класса , MergeEventArgs чтобы задать для свойства Cancelзначение true.

Если код обработчика событий использует CancelableArgs свойство для задания строк Message свойств или MessageDetails , но для свойства CancelableArgs.Cancel остается значение по умолчанию false, сообщение об успешном выполнении будет отображаться с текстом свойств Message и MessageDetails . Это сообщение переопределит пользовательские настройки сообщений Показывать сообщения об успешном или неудачном завершении и В случае успеха в диалоговом окне Параметры отправки формы.

Аналогичным образом, если код обработчика событий задает строки Message или MessageDetails и задает для CancelableArgs.Cancelзначение true, появится сообщение об ошибке, сообщение будет отображаться с текстом свойств Message и MessageDetails , переопределяя параметры диалогового окна "Параметры отправки формы".

Если код обработчика событий оставляет свойства Message и MessageDetails со значением по умолчанию пустой ссылки (Nothing в Visual Basic), но задает cancelableArgs.Cancel значение true, то операция отправки считается неудачной. Последует ли сообщение об ошибке, а также его содержимое определяется с помощью параметров в диалоговом окне Параметры отправки.

Quit() Вызовы метода Application класса не могут выполняться в обработчике Submit событий.

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