DSO(data source object)로부터 지정된 이름의 데이터 구성원에 해당하는 레코드세트(recordset) 개체를 반환한다.
반환값 oItem은 성공적이면 리코드세트를 반환하고, 지정된 데이터 구성원이나 하부 챕터가 없어 실패하면 null을 반환한다.
데이터 구성원의 유효한 이름은 DSO(data source object) 적용에 맞는 이름이어야 한다.
null 값이나 빈 문자열을 namedRecordset 메서드에 전달하면, 디폴트 리코드세트가 반환된다. 이는 recordset 속성을 작접적으로 참조하는 것과 동일하다..
두번째 파라메터가 생략되면, 최상위 리코드세트가 반환된다. 처음 파라메터가 생략되고, 두번째 파라메터가 지정되면, 디폴트 리코드세트의 지정된 하부 챕터(subchapter)가 반환된다.
| 개체 | script | IE |
|---|
이름있는 리코드세트는 스프레드쉬트 첫 컬럼에서 제일 먼저 7 칸에 해당한다. namedRecordset 메서드를 사용하여 스프레드쉬트로 부터 데이터를 제공하는 가정적인 DSO의 ondatasetcomplete 이벤트의 처리자에서 이름있는 리코드세트로부터 반환받는다. 리코드세트의 이름은 event 개체의 qualifier 속성값에 해당한다. 예제의 classid는 작용하지 않는다.
<SCRIPT>
function handle_dscomplete(){ // 모든 데이터가 준비되면 발생된다.
var oEvent=window.event;
if (oEvent.qualifier !=''){ // 디폴트 리코드세트의 통보는 무시된다.
var oNamedRS=oEvent.srcElement.namedRecordset(oEvent.qualifier); // qualifier 속성으로 지정된 이름있는 리코드세트를 참조
oNamedRS.MoveFirst(); // 이름있는 리코드세트에서 작업
for (i=0;i< oNamedRS.RecordCount;i++){
var vValue=oNamedRS.Fields(0).value;
oNamedRS.MoveNext();
}
}
}
</SCRIPT>
<OBJECT classid="clsid:00000000-0000-0000-0000-000000000000" id="dsoSpreadSheet"
ondatasetcomplete="handle_dscomplete()">
</OBJECT>
<TABLE datasrc="#dsoSpreadsheet.A1:A7" border=1>
<TR><TD><SPAN datafld="A"></SPAN></TD></TR>
</TABLE>