InfoPath 2003 オブジェクトモデルを使用する初期化コードと後処理コード

[アーティクル]
04/04/2023

既定では、InfoPath 2003 と互換性のあるフォームテンプレートプロジェクトについて作成される FormCode.cs または FormCode.vb ファイルには、フォームのプログラムロジックに対するすべてのソースコードが含まれています。プロジェクトのテンプレートによって FormCode.cs または FormCode.vb ファイルに以下の例とよく似たクラスが生成され、このクラスには、フォームイベントのハンドラーだけでなく、初期化コードと後処理コードも定義できます。 FormCode.cs および FormCode.vb ファイルは、イベントハンドラーが実装される唯一のクラスとしてこのクラスを識別する、アセンブリレベルの System.ComponentModel.DescriptionAttribute 属性を使用します。 InfoPathNamespace 属性 ( InfoPathNamespaceAttribute 型が実装する) をクラスに適用して、クラス内で使用する XML DOM セレクション名前空間を識別します。 InfoPathNamespace で参照される名前空間は、InfoPath プロジェクトシステムによって管理されます。

FormCode クラス自体には、フォームが開いている間に標準の InfoPath 機能に加えて必要なすべてのコンポーネントの初期化およびクリーンルーチンを実行するために使用されるメソッドと _Shutdown メソッドが用意_Startupされています。

重要

および _Shutdown メソッド内から InfoPath オブジェクトモデルのメンバーを_Startup呼び出さないでください。これらのメソッドでは、外部コンポーネントのメンバーだけを初期化し、呼び出さなければなりません。

using System;
using Microsoft.Office.Interop.InfoPath.SemiTrust;
// Office integration attribute. Identifies the startup class for the form. Do not
// modify.
[assembly: System.ComponentModel.DescriptionAttribute(
    "InfoPathStartupClass, Version=1.0, Class=Template1.FormCode")]
namespace Template1
{
    // The namespace prefixes defined in this attribute must remain synchronized with
    // those in the form definition file (.xsf).
    [InfoPathNamespace(
        "xmlns:my='http://schemas.microsoft.com/office/infopath/2003/myXSD/2004-03-29T22-27-27'")]
    public partial class FormCode
    {
        private XDocument thisXDocument;
        private Application thisApplication;
        public void _Startup(Application app, XDocument doc)
        {
            thisXDocument = doc;
            thisApplication = app;
            // You can add additional initialization code here.
        }
        public void _Shutdown()
        {
        }
    }
}

Imports System
Imports Microsoft.Office.Interop.InfoPath.SemiTrust
Imports Microsoft.VisualBasic
' Office integration attribute. Identifies the startup class for the form. Do not
' modify.
<Assembly: System.ComponentModel.DescriptionAttribute( _
    "InfoPathStartupClass, Version=1.0, Class=Template1.FormCode")>
Namespace Template1
    ' The namespace prefixes defined in this attribute must remain synchronized with
    ' those in the form definition file (.xsf).
    <InfoPathNamespace( _
        "xmlns:my='http://schemas.microsoft.com/office/infopath/2003/myXSD/2004-03-29T22-36-40'")> _
    Public Class FormCode
        Private thisXDocument As XDocument
        Private thisApplication As Application
        Public Sub _Startup(app As Application, doc As XDocument)
            thisXDocument = doc
            thisApplication = app
            ' You can add additional initialization code here.
        End Sub
        Public Sub _Shutdown()
        End Sub
    End Class
End Namespace

_Startup メソッド

メソッドは、追加のコンポーネントの初期化コードを記述する場所を提供するだけでなく、_StartupInfoPath オブジェクトモデルの XDocument クラスと thisApplicationApplication クラスのメンバーにアクセスするためにフォームコードで使用できる変数と変数を初期化thisXDocumentします。この 2 つの変数を初期化するために必要なコードは、プロジェクトテンプレートによって自動的に生成されます。

    private XDocument thisXDocument;
    private Application thisApplication;
    public void _Startup(Application app, XDocument doc)
    {
        thisXDocument = doc;
        thisApplication = app;
        // You can add additional initialization code here.
    }

    Private thisXDocument As XDocument
    Private thisApplication As Application
    Public Sub _Startup(app As Application, doc As XDocument)
        thisXDocument = doc
        thisApplication = app
        ' You can add additional initialization code here.
    End Sub

次の例では、変数を使用して UIObject 型の thisXDocumentAlert メソッドにアクセスするボタンの単純なイベントハンドラーを示します。

[InfoPathEventHandler(MatchPath="CTRL1_5", EventType=InfoPathEventType.OnClick)]
public void CTRL1_5_OnClick(DocActionEvent e)
{
    // Write your code here.
    thisXDocument.UI.Alert("Hello!");
}

<InfoPathEventHandler(MatchPath:="CTRL1_5", EventType:=InfoPathEventType.OnClick)> _
Public Sub CTRL1_5_OnClick(ByVal e As DocActionEvent)
    ' Write your code here.
    thisXDocument.UI.Alert("Hello!")
End Sub

イベントハンドラーの作成方法については、「InfoPath 2003 オブジェクトモデルを使用してイベントハンドラーを追加する方法」を参照してください。

_ShutDown メソッド

メソッドは _Shutdown 、フォームが閉じられたときに呼び出される最後のメソッドです。フォームで使用するコンポーネントの後処理に必要なコードは、このメソッドに記述できます。

    public void _Shutdown()
    {
    }

    Public Sub _Shutdown()
    End    Sub

初期化コードと後処理コードの例

次の例では、メソッドで Microsoft SQL Server データベースへの接続を初期化し、メソッドで_Startup接続を閉じる方法を_Shutdown示します。この例を正しく機能させるには、まず、[プロジェクト] メニューの [参照の追加] をクリックして、.NET Frameworkの System.Data アセンブリへの参照を設定し、[.NET] タブで System.Data.dll コンポーネントを選択する必要があります。また、キーストロークをusing System.Data.SqlClient減らすために、 (または Imports System.Data.SqlClient) ディレクティブがフォームコードファイルの上部に追加されていることにも注意してください。

注:

InfoPath フォームに SQL Server データベースに接続するフォームコードが含まれている場合、フォームの展開方法およびセキュリティポリシーの定義方法によっては、ユーザーにセキュリティのアクセス許可が必要になることがあります。セキュリティの詳細については、「コードを含むフォームテンプレートのセキュリティモデルについて」および「コードを含むフォームテンプレートのセキュリティ設定を構成する方法」を参照してください。

using System;
using System.Data.SqlClient;
using Microsoft.Office.Interop.InfoPath.SemiTrust;
// Office integration attribute. Identifies the startup class for the form. Do not
// modify.
[assembly: System.ComponentModel.DescriptionAttribute(
    "InfoPathStartupClass, Version=1.0, Class=Template1.FormCode")]
namespace Template1
{
    // The namespace prefixes defined in this attribute must remain synchronized with
    // those in the form definition file (.xsf).
    [InfoPathNamespace(
        "xmlns:my='http://schemas.microsoft.com/office/infopath/2003/myXSD/2004-03-05T20-56-13'")]
    public partial class Template1
    {
        private XDocument    thisXDocument;
        private Application    thisApplication;
        private SqlConnection sqlConnect;
        public void _Startup(Application app, XDocument doc)
        {
            thisXDocument = doc;
            thisApplication = app;
            // Initialize variable for SQL Server connection.
            sqlConnect= new SqlConnection("server=localhost;Trusted_Connection=yes;database=Northwind");
        }
        public void _Shutdown()
        {
            // Close SQL Server connection at shut down.
            sqlConnect.Close();
        }
    }
}

Imports System
Imports System.Data.SqlClient
Imports Microsoft.Office.Interop.InfoPath.SemiTrust
Imports Microsoft.VisualBasic
' Office integration attribute. Identifies the startup class for the form. Do not
' modify.
<Assembly: System.ComponentModel.DescriptionAttribute( _
    "InfoPathStartupClass, Version=1.0, Class=Template1.FormCode")>
Namespace Template1
        ' The namespace prefixes defined in this attribute must remain synchronized with
        ' those in the form definition file (.xsf).
        <InfoPathNamespace( _
            "xmlns:my='http://schemas.microsoft.com/office/infopath/2003/myXSD/2004-03-08T18-47-33'")>        _
        Public Class Template1
            Private thisXDocument As XDocument
            Private thisApplication As Application
            Private sqlConnect As SqlConnection
            Public Sub _Startup(app As Application, doc As XDocument)
                thisXDocument = doc
                thisApplication = app
                ' Initialize variable for SQL Server connection.
                sqlConnect = New SqlConnection _("server=localhost;Trusted_Connection=yes;database=Northwind")
            End Sub
        Public Sub _Shutdown()
            ' Close SQL Server connection.
            sqlConnect.Close()
        End Sub
    End Class
End Namespace

InfoPath 2003 オブジェクトモデルを使用する初期化コードと後処理コード

_Startup メソッド

_ShutDown メソッド

初期化コードと後処理コードの例

関連項目

その他のリソース

InfoPath 2003 オブジェクト モデルを使用する初期化コードと後処理コード

_Startup メソッド

_ShutDown メソッド

初期化コードと後処理コードの例

関連項目

その他のリソース

InfoPath 2003 オブジェクトモデルを使用する初期化コードと後処理コード