DataSource.SetNamedNodeProperty メソッド
指定した XML ノードの名前付きプロパティの値を設定します。このノードは、メイン データ ソースの nonattribute ノードである必要があります。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride Sub SetNamedNodeProperty ( _
target As XPathNavigator, _
name As String, _
value As String _
)
'使用
Dim instance As DataSource
Dim target As XPathNavigator
Dim name As String
Dim value As String
instance.SetNamedNodeProperty(target, _
name, value)
public abstract void SetNamedNodeProperty(
XPathNavigator target,
string name,
string value
)
パラメーター
- target
型: System.Xml.XPath.XPathNavigator
メイン データ ソースの nonattribute ノードに対応する XML ノードに配置された XPathNavigator オブジェクト。このノードの名前付きプロパティが設定されることになります。
- name
型: System.String
設定するプロパティの名前。
- value
型: System.String
プロパティに設定する値。
例外
| 例外 | 条件 |
|---|---|
| ArgumentException | 指定した XML ノードは無効です。 |
| ArgumentException | 指定したプロパティ名は無効です。 |
| ArgumentNullException | このメソッドに渡されたパラメーターは null 参照 (Visual Basic ではNothing ) です。 |
| ArgumentException | このメソッドに渡されたパラメーターは有効ではありません。たとえば、型または形式が正しくありません。 |
解説
名前付きプロパティを使用すると、ユーザーがメイン データ ソースに含まれている XML 要素ノードのユーザー定義プロパティに文字列を関連付けることができるようになります。名前付きプロパティの値は、SetNamedNodeProperty メソッドを使用して設定できます。名前付きプロパティの値を読み込むには、GetNamedNodeProperty メソッドを使用します。
SetNamedNodeProperty メソッドで設定されたプロパティ値は、フォームの保存時に保存されません。
このメンバーには、現在開いているフォームと同じドメインで実行中のフォーム、またはクロスドメインのアクセス許可が与えられたフォームのみがアクセスできます。
この型またはメンバーには、Microsoft InfoPath Filler または Web ブラウザーで開かれたフォームを実行中のコードからアクセスできます。