FileSubmitConnection.Filename プロパティ
フォームが FileSubmitConnection オブジェクトによって送信されたときに現在のフォームに与えられるファイル名に評価される XPathTypedValue を取得します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride ReadOnly Property Filename As XPathTypedValue
Get
'使用
Dim instance As FileSubmitConnection
Dim value As XPathTypedValue
value = instance.Filename
public abstract XPathTypedValue Filename { get; }
プロパティ値
型: Microsoft.Office.InfoPath.XPathTypedValue
フォームが送信されたときにそれに与えられるファイル名に評価される XPathTypedValue。
解説
FileSubmitConnection クラスの Filename プロパティの値は、XPathTypedValue オブジェクトとして返されます。これは、XPathTypedValue クラスの SetStringValue メソッドを使用してリテラル文字列として指定するか、XPathTypedValue クラスの XPath プロパティを使用して XPath 式を指定することにより設定できます。詳細およびコード サンプルについては、XPathTypedValue クラスの説明を参照してください。
ファイル名拡張子 ".xml" が含まれていない場合は、この拡張子が文字列に追加されます。Filename プロパティが null 参照 (Visual Basic ではNothing ) になっている場合、フォームが送信されたときにそれに与えられる名前は "Form.xml" になります。
[データ接続ウィザード] の [ファイル名] ボックスに concat("Status Report -", field1) などの XPath 式が指定されている場合、データ接続が定義済みであれば、次の例に示すように、XPathTypedValue クラスの XPath プロパティを使用してその式を返すことができます。
FileSubmitConnection submitConnection =
(FileSubmitConnection)(DataConnections["SharePoint Library"]);
MessageBox.Show (submitConnection.Filename.XPath.ToString());
Dim submitConnection As FileSubmitConnection =
DirectCast(DataConnections["SharePoint Library"], _
FileSubmitConnection)
MessageBox.Show (submitConnection.Filename.XPath.ToString())
このメンバーには、現在開いているフォームと同じドメインで実行中のフォーム、またはクロスドメインのアクセス許可が与えられたフォームのみがアクセスできます。
この型またはメンバーには、Microsoft InfoPath Filler または Web ブラウザーで開かれたフォームを実行中のコードからアクセスできます。
例
次の例は、FileSubmitConnection オブジェクトの Filename プロパティを使用して、フォームをデータ接続に送信するときに使用されるファイル名を表示しています。
FileSubmitConnection submitConnection =
(FileSubmitConnection)(DataConnections["SharePoint Library"]);
MessageBox.Show (submitConnection.Filename.ToString());
Dim submitConnection As FileSubmitConnection =
DirectCast(DataConnections["SharePoint Library"], _
FileSubmitConnection)
MessageBox.Show (submitConnection.Filename.ToString())