XPathTypedValue クラス
EmailSubmitConnection クラスおよび FileSubmitConnection クラスの特定のプロパティ値により返されるオブジェクトを実装して、それらの値を取得または設定します。
継承階層
System.Object
Microsoft.Office.InfoPath.XPathTypedValue
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustInherit Class XPathTypedValue
'使用
Dim instance As XPathTypedValue
public abstract class XPathTypedValue
解説
XPathTypedValue オブジェクトは、EmailSubmitConnection クラスの以下のメンバーによって、それらの値を取得または設定するために返されます。
XPathTypedValue オブジェクトは、EmailSubmitConnection クラスの Filename プロパティによって、その値を取得または設定するために返されます。
これらのプロパティを読み取ったり設定したりするには、XPathTypedValue クラスのプロパティおよびメソッドを使用する必要があります。
XPathTypedValue オブジェクトを返すプロパティの値は、リテラル文字列を指定するか、または XPath 式を指定することにより設定できます。XPath 式を使用すると、そのフォーム上 (またはフォームのデータ ソース内のその他のどれかのノード) のフィールドから値を取り出すことによりプロパティを設定できます。さらに、XPath 演算子と関数を使用すると、取得したデータに対してその他の操作を実行できます。
プロパティの値をリテラル文字列として設定するには、XPathTypedValue クラスの SetStringValue メソッドを使用します。
次の例は、SetStringValue メソッドを使用して電子メール アドレスをリテラル文字列として指定することにより、EmailSubmitConnection クラスの To プロパティの値を設定する方法を示しています。
// Get the e-mail submit data connection configured for the form.
EmailSubmitConnection mySubmit = (EmailSubmitConnection)
(this.DataConnections["Email Submit"]);
// Set To property to literal string value.
mySubmit.To.SetStringValue("someone@example.com");
// Submit form.
mySubmit.Execute();
' Get the e-mail submit data connection configured for the form.
Dim mySubmit As EmailSubmitConnection = DirectCast(_
Me.DataConnections["Email Submit"], EmailSubmitConnection)
' Set To property to literal string value.
mySubmit.To.SetStringValue("someone@example.com")
' Submit form.
mySubmit.Execute()
プロパティの値を XPath 式として設定するには、XPathTypedValue クラスの XPath プロパティを使用します。
次の例は、XPath プロパティを使用して、フォーム上の ToAddress フィールドから値を取り出す XPath 式を電子メール アドレスとして指定することによって、EmailSubmitConnection クラスの To プロパティの値を設定する方法を示しています。
// Get the e-mail submit data connection configured for the form.
EmailSubmitConnection mySubmit = (EmailSubmitConnection)
(this.DataConnections["Email Submit"]);
// Set To property to XPath for ToAddress field.
mySubmit.To.XPath = "/my:myFields/my:ToAddress";
// Submit form.
mySubmit.Execute();
' Get the e-mail submit data connection configured for the form.
Dim mySubmit As EmailSubmitConnection = DirectCast(_
Me.DataConnections["Email Submit"], EmailSubmitConnection)
' Set To property to XPath for ToAddress field.
mySubmit.To = "/my:myFields/my:ToAddress"
' Submit form.
mySubmit.Execute()
XPathTypedValue オブジェクトとして返されたプロパティの値を読み取るには、XPathTypedValue クラスの Evaluate メソッドを使用して XPath 式を評価し、その結果を文字列として返すか、または XPathTypedValue クラスの ToString メソッドを使用してリテラル文字列を返します。
スレッドの安全性
この型の public static (Visual Basic ではShared ) メンバーはスレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。