FormEvents.Save Событие

Определение

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

Microsoft.Office.InfoPath

Сборка:

Microsoft.Office.InfoPath.dll

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

public:
 abstract event Microsoft::Office::InfoPath::SaveEventHandler ^ Save;

public abstract event Microsoft.Office.InfoPath.SaveEventHandler Save;

member this.Save : Microsoft.Office.InfoPath.SaveEventHandler 

Public MustOverride Custom Event Save As SaveEventHandler 

Тип события

SaveEventHandler

Исключения

InvalidOperationException

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

Примеры

В следующем примере обработчик события для события Save проверяет, пустое ли поле Field2, и если нет, выполняет операцию сохранения. Если поле пустое, он отображает сообщение и отменяет операцию сохранения.

public void FormEvents_Save(object sender, SaveEventArgs e)
{
   // Check to see if Field2 is empty.
   XPathNavigator reqField = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:field2", 
      NamespaceManager);
   if(reqField.ToString() == "")
   {
      MessageBox.Show("Field2 is empty.\nYou cannot save the form.");
      e.CancelableArg.Cancel = true;
   }
   else
   {
   // The Dirty property will be set to false if save is successful.
      e.PerformSaveOperation();
      e.CancelableArgs.Cancel = false;
   }
}

Public Sub FormEvents_Save(ByVal sender As Object, _
   ByVal e As SaveEventArgs)
   ' Check to see if Field2 is empty.
   Dim reqField as XPathNavigator = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:field2", _
      NamespaceManager)
   If(reqField.ToString() = "") Then
      MessageBox.Show("Field2 is empty" & vbNewLine & _
         "You cannot save the form.")
      e.CancelableArgs.Cancel = True
   Else
   ' The Dirty property will be set to false if save is successful.
   e.PerformSaveOperation()
   e.CancelableArgs.Cancel = False
   End If
End Sub

Комментарии

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

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

Событие Save привязано с помощью делегата SaveEventHandler .

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

Объект SaveEventArgs , который передается в качестве параметра обработчику событий для события Save , предоставляет свойства и методы, которые можно использовать для получения имени файла формы, определения состояния сохранения и выполнения операции сохранения.

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