FileSubmitConnection.Filename プロパティ

フォームが FileSubmitConnection オブジェクトによって送信されたときに現在のフォームに与えられるファイル名に評価される XPathTypedValue を取得します。

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

構文

'宣言
Public MustOverride ReadOnly Property Filename As XPathTypedValue
'使用
Dim instance As FileSubmitConnection
Dim value As XPathTypedValue

value = instance.Filename

public abstract XPathTypedValue Filename { get; }

プロパティ値

フォームが送信されたときにそれに与えられるファイル名に評価される XPathTypedValue。

コメント

FileSubmitConnection クラスの Filename プロパティの値は、XPathTypedValue オブジェクトとして返されます。これは、XPathTypedValue クラスの SetStringValue メソッドを使用してリテラル文字列として指定するか、XPathTypedValue クラスの XPath プロパティを使用して XPath 式を指定することにより設定できます。詳細およびコード サンプルについては、XPathTypedValue クラスの説明を参照してください。

ファイル名拡張子 ".xml" が含まれていない場合は、この拡張子が文字列に追加されます。 Filename プロパティが null になっている場合、フォームが送信されたときにそれに与えられる名前は "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 Office InfoPath 2007 または 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())

関連項目

参照

FileSubmitConnection クラス
FileSubmitConnection のメンバ
Microsoft.Office.InfoPath 名前空間