SignatureCollection.CreateSignature メソッド
フォームに追加することなく、新しい Signature オブジェクトを作成します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride Function CreateSignature As Signature
'使用
Dim instance As SignatureCollection
Dim returnValue As Signature
returnValue = instance.CreateSignature()
public abstract Signature CreateSignature()
戻り値
型: Microsoft.Office.InfoPath.Signature
ビューのスナップショットと、追加の署名情報を含む新しい Signature オブジェクト。
例外
| 例外 | 条件 |
|---|---|
| SecurityException | フォーム テンプレートが、[フォームのオプション] ダイアログ ボックスの [セキュリティと信頼] カテゴリを使用して [完全信頼] として構成されていません。 |
解説
CreateSignature メソッドは、フォームに署名を追加することなく、新しい署名を作成します (ビューのスナップショットと、追加の署名情報を取得します)。この署名をフォームに追加するには、Signature クラスの Sign メソッドを呼び出す必要があります。
このメソッドは、Sign イベントのイベント ハンドラーからのみ呼び出すことができます。
このメンバーには、[フォームのオプション] ダイアログ ボックスの [セキュリティ] または [信頼] カテゴリを使用して、完全な信頼を与えられて実行するように構成されたフォーム テンプレートから開かれたフォームのみがアクセスできます。このメンバーは、直接の呼び出し側の完全な信頼が必要であり、部分的に信頼されたコードでは使用できません。詳細については、MSDN の「部分信頼コードからのライブラリの使用」を参照してください。
この型またはメンバーには、Microsoft InfoPath Filler で開かれたフォームを実行中のコードからのみアクセスできます。
例
次の例では、Sign イベントのイベント ハンドラーを追加するときにフォーム テンプレートに追加されるコード スケルトンを示しています。CreateSignature メソッドを使用して新しい Signature オブジェクトを作成します。Signature クラスの Sign メソッドを呼び出すと、新しい Signature オブジェクトがフォームの SignatureCollection オブジェクトに追加されます。
public void FormEvents_Sign(object sender, SignEventArgs e)
{
// This event handler will run only in fully trusted form templates.
Signature thisSignature =
e.SignedDataBlock.Signatures.CreateSignature();
// To add other pieces of information to sign, modify the
// signature template returned by
// thisSignature.SignatureBlockXmlNode.
// Write your code here.
thisSignature.Sign();
e.SignatureWizard = false;
}
Public Sub FormEvents_Sign(ByVal sender As Object, _
ByVal e As SignEventArgs)
' This event handler will run only in fully trusted form templates.
Dim thisSignature As Signature = _
e.SignedDataBlock.Signatures.CreateSignature()
' To add other pieces of information to sign, modify the
' signature template returned by
' thisSignature.SignatureBlockXmlNode.
' Write your code here.
thisSignature.Sign()
e.SignatureWizard = False
End Sub