Metoda WorksheetBase.XmlMapQuery —
Pobiera Range obiekt, który reprezentuje komórki zamapowane do określonej XPath.Pobiera nullodwołanie o wartości null (Nothing w języku Visual Basic) Jeśli określonym XPath nie zostało zamapowane do arkusza.
Przestrzeń nazw: Microsoft.Office.Tools.Excel
Zestaw: Microsoft.Office.Tools.Excel.v4.0.Utilities (w Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Składnia
'Deklaracja
Public Function XmlMapQuery ( _
xPath As String, _
selectionNamespaces As Object, _
map As Object _
) As Range
public Range XmlMapQuery(
string xPath,
Object selectionNamespaces,
Object map
)
Parametry
- xPath
Typ: System.String
Wyrażenia XPath dla kwerendy dla.
- selectionNamespaces
Typ: System.Object
Rozdzielany spacjami ciąg, który zawiera obszary nazw, do których odwołuje się w parametrze XPath.Jeśli jeden z określonych obszarów nazw nie można rozpoznać, zostanie wygenerowany błąd w czasie wykonywania.
- map
Typ: System.Object
An XmlMap.Umożliwia określenie mapę XML, jeśli chcesz wykonać kwerendę dla XPath w obrębie określonej mapy.
Wartość zwracana
Typ: Microsoft.Office.Interop.Excel.Range
A Range obiekt, który reprezentuje komórki zamapowane do określonej XPath; nullodwołanie o wartości null (Nothing w języku Visual Basic)Jeśli określonym XPath nie zostało zamapowane do arkusza.
Uwagi
Funkcje języka XML, oprócz zapisywania plików w formacie arkusza kalkulacyjnego XML, są dostępne tylko w programie Microsoft Office Professional Edition 2003 i Microsoft Office Excel 2003.
W przeciwieństwie do XmlDataQuery metodę, XmlMapQuery metoda zwraca cała kolumna listy XML, tym wiersz nagłówka i wiersza wstawiania.
Parametry opcjonalne
Aby uzyskać informacje o opcjonalnych parametrów, zobacz Parametry opcjonalne w rozwiązania dla pakietu Office.
Przykłady
Następujący kod w przykładzie wykorzystano XmlMapQuery sposób, aby Range komórek mapowany do określonego wyrażenie XPath.
Ten przykład dotyczy dostosowywania poziomie dokumentu.
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);
if (range1 == null)
{
MessageBox.Show("The specified XPath: '" + path +
"' has not been mapped to the worksheet.");
}
}
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..