WorksheetBase.XmlDataQuery 메서드
특정 XPath에 매핑된 셀을 나타내는 Range 개체를 가져옵니다.지정된 XPath가 워크시트에 매핑되지 않았거나 매핑된 범위가 비어 있으면 nullNull 참조(Visual Basic의 경우 Nothing)을 가져옵니다.
네임스페이스: Microsoft.Office.Tools.Excel
어셈블리: Microsoft.Office.Tools.Excel.v4.0.Utilities(Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
구문
‘선언
Public Function XmlDataQuery ( _
xPath As String, _
selectionNamespaces As Object, _
map As Object _
) As Range
public Range XmlDataQuery(
string xPath,
Object selectionNamespaces,
Object map
)
매개 변수
- xPath
형식: System.String
쿼리할 XPath입니다.
- selectionNamespaces
형식: System.Object
XPath 매개 변수에서 참조되는 네임스페이스를 포함하며 공백으로 구분된 문자열입니다.지정한 네임스페이스 중 하나를 확인할 수 없으면 런타임 오류가 발생합니다.
- map
형식: System.Object
XmlMap 입니다.특정 맵 내에서 XPath를 쿼리하려면 XML 맵을 지정합니다.
반환 값
형식: Microsoft.Office.Interop.Excel.Range
특정 XPath에 매핑된 셀을 나타내는 Range 개체입니다. 워크시트에 특정 XPath가 매핑되지 않았거나 매핑된 범위가 비어 있으면 nullNull 참조(Visual Basic의 경우 Nothing)입니다.
설명
파일을 XML 스프레드시트 형식으로 저장하는 것을 제외하고 XML 기능은 Microsoft Office Professional Edition 2003과 Microsoft Office Excel 2003에서만 사용할 수 있습니다.
XPath가 XML 목록의 열에 있으면 반환된 Range 개체에는 머리글 행 또는 삽입 행이 포함되어 있지 않습니다.
선택적 매개 변수
선택적 매개 변수에 대한 자세한 내용은 Office 솔루션의 선택적 매개 변수를 참조하십시오.
예제
다음 코드 예제에서는 XmlDataQuery 메서드를 사용하여 특정 XPath에 매핑된 셀의 Range를 가져옵니다.
이 예제는 문서 수준 사용자 지정을 위한 것입니다.
Private Sub WorksheetQueryXmlData()
Dim path As String = "/order/customer/address"
Dim namespaces As String = "xmlns=https://www.contoso.com/orders"
Dim range1 As Excel.Range = _
Me.XmlDataQuery(path, namespaces)
If range1 Is Nothing Then
MsgBox("The specified XPath: '" & path & _
"' has not been mapped to the worksheet, or the mapped " & _
"range is empty.")
End If
End Sub
private void WorksheetQueryXmlData()
{
string path = "/order/customer/address";
string namespaces = "xmlns=https://www.contoso.com/orders";
Excel.Range range1 = this.XmlDataQuery(path, namespaces);
if (range1 == null)
{
MessageBox.Show("The specified XPath: '" + path +
"' has not been mapped to the worksheet, or the mapped " +
"range is empty.");
}
}
.NET Framework 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.