getStringValue (DOMElement - JavaScript)

データエレメントのストリング値を取得します。

定義場所

構文

getStringValue() : string

getStringValue(xpath:string) : string

getStringValue(xpath:string, selectionNS:NamespaceContext) : string

パラメータ	説明
`xpath`	文書に関連付けられたエレメントの XPath です。
`selectionNS`	namespace コンテキストです。

戻り値	説明
`string`	エレメントのストリング値。

使用法

このメソッドは DOMDocument の getStringValue と同等です。

スキーマでは、このデータエレメントを string と定義する必要があります。データプロパティでは、関連あるフィールドの表示タイプが String でなければなりません。

このメソッドは以下のいずれかに対して機能します。

現在のエレメント (パラメータが指定されていない場合)。
XPath に一致する最初のエレメント。

XPath が名前空間プレフィックスを含む場合は、第 2 パラメータで名前空間を定義し、最初に新規の NamespaceContextImpl オブジェクトを作成してから addNamespace で名前空間を追加してください。

例

(1) このボタンの onclick イベントは、DOM の第 2 レベルにある最初の子であるエレメントのストリング値を取得します。requestScope 変数がページの編集ボックスにバインドされているため、ユーザーが i を指定してからボタンをクリックすると、y または msg が返されます。

var dc = database.getAllDocuments();
if(dc.getDocumentCount() > 0) {
	if(requestScope.i != null &&
	requestScope.i >= 0 && 
	requestScope.i < dc.getDocumentCount()) {
		var ar = dc.getDocumentArray(requestScope.i + 1);
		var doc = ar[i];
		var schema = doc.getDocumentElement();
		var elem = schema.getFirstChild();
		requestScope.y = elem.getStringValue();
	} else {
		requestScope.msg = "No such document";
	}
} else {
	requestScope.msg = "No documents in database";
}

アクセスする文書の XML が以下のようになっている場合、サンプルコードを実行すると foo が返されます。

<schema0>
  <element0>foo</element0>
</schema0>

(2) このボタンの onclick イベントは、XPath に一致する最初のエレメントのストリング値を取得します。requestScope 変数がページの編集ボックスにバインドされているため、ユーザーが i を指定してからボタンをクリックすると、y または msg が返されます。

var dc = database.getAllDocuments();
if(dc.getDocumentCount() > 0) {
	if(requestScope.i != null &&
	requestScope.i >= 0 && 
	requestScope.i < dc.getDocumentCount()) {
		var ar = dc.getDocumentArray(requestScope.i + 1);
		var doc = ar[i];
		var elem = doc.getDocumentElement();
		requestScope.y = elem.getStringValue("/schema0/element0");
		
	} else {
		requestScope.msg = "No such document";
	}
} else {
	requestScope.msg = "No documents in database";
}

(3) このボタンの onclick イベントは、名前空間を使用する XPath に一致する最初のエレメントのストリング値を取得します。requestScope 変数がページの編集ボックスにバインドされているため、ユーザーが i を指定してからボタンをクリックすると、y または msg が返されます。

var dc = database.getAllDocuments();
if(dc.getDocumentCount() > 0) {
	if(requestScope.i != null &&
	requestScope.i >= 0 && 
	requestScope.i < dc.getDocumentCount()) {
		var ns = new NamespaceContextImpl();
		ns.addNamespace("p", "http://mynamespace.com");
		var ar = dc.getDocumentArray(requestScope.i + 1);
		var doc = ar[i];
		var elem = doc.getDocumentElement();
		requestScope.y = elem.getStringValue("/p:schema0/p:element0", ns);
		
	} else {
		requestScope.msg = "No such document";
	}
} else {
	requestScope.msg = "No documents in database";
}