WorksheetBase.XmlMapQuery 메서드

아티클
08/10/2011

특정 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 XmlMapQuery ( _
    xPath As String, _
    selectionNamespaces As Object, _
    map As Object _
) As Range

public Range XmlMapQuery(
    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에서만 사용할 수 있습니다.

XmlDataQuery 메서드와 달리 XmlMapQuery 메서드는 머리글 행과 삽입 행을 포함하여 XML 목록의 전체 열을 반환합니다.

선택적 매개 변수

선택적 매개 변수에 대한 자세한 내용은 Office 솔루션의 선택적 매개 변수를 참조하십시오.

예제

다음 코드 예제에서는 XmlMapQuery 메서드를 사용하여 특정 XPath에 매핑된 셀의 Range를 가져옵니다.

이 예제는 문서 수준 사용자 지정을 위한 것입니다.

Private Sub WorksheetQueryXmlMap()
    Dim path As String = "/order/customer/address"
    Dim namespaces As String = "xmlns=https://www.contoso.com/orders"

    Dim range1 As Excel.Range = _
        Me.XmlMapQuery(path, namespaces)

    If range1 Is Nothing Then
        MsgBox("The specified XPath: '" & path & _
            "' has not been mapped to the worksheet.")
    End If
End Sub

private void WorksheetQueryXmlMap()
{
    string path = "/order/customer/address";
    string namespaces = "xmlns=https://www.contoso.com/orders";

    Excel.Range range1 = this.XmlMapQuery(path, namespaces, missing);

    if (range1 == null)
    {
        MessageBox.Show("The specified XPath: '" + path +
            "' has not been mapped to the worksheet.");
    }
}

.NET Framework 보안

직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

WorksheetBase 클래스

Microsoft.Office.Tools.Excel 네임스페이스

Share via