XmlForm.New プロパティ

フォームが新規かどうかを指定する値を取得します。

名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (microsoft.office.infopath.dll 内)

構文

'宣言
Public MustOverride ReadOnly Property New As Boolean
'使用
Dim instance As XmlForm
Dim value As Boolean

value = instance.New

public abstract bool New { get; }

フォームが新規の場合は true、それ以外の場合は false。

New プロパティは、新しいフォームが Microsoft Office InfoPath 2007 で作成されたか、Web ブラウザで作成されたかによって、動作が異なります。

Web ブラウザでは、新しいフォームが作成されると、New プロパティは true に設定されます。このプロパティは、既存のフォームが開かれた場合にのみ、false に設定されます。

InfoPath では、新しいフォームが作成されると、New プロパティは true に設定されます。このプロパティは、フォームの保存が正常に終了すると、直ちに false に設定されます。既存のフォームが開かれた場合にも、false に設定されます。

メモ :
New プロパティは、COM/スクリプトオブジェクトモデルにおける XDocument オブジェクトの IsNew プロパティに相当し、InfoPath 2003 互換マネージコードオブジェクトモデルにおける _XDocument2 インターフェイスの IsNew プロパティに相当します。

このメンバは、現在開いているフォームと同じドメイン内で実行されているフォーム、またはドメインを越えたアクセス許可を付与されているフォームだけがアクセスできます。

この型またはメンバは、Microsoft Office InfoPath 2007 または Web ブラウザで開いているフォームで実行されているコードからのみアクセスできます。

次の例では、New プロパティを使用して、フォームが新規かどうかによって条件付きでコードを実行するパターンを示します。

if (this.New)
{
   // Code to run if form is new.
}
else
{
   // Code to run if form is not new.
}

If (Me.[New]) Then
   ' Code to run if form is new.
Else
   ' Code to run if form is not new.
End If