Udostępnij za pośrednictwem

Metoda WorkbookBase.XmlImport —

  • Artykuł

Importuje plik danych XML do bieżącego skoroszytu.

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 XmlImport ( _
    url As String, _
    <OutAttribute> ByRef importMap As XmlMap, _
    overwrite As Object, _
    destination As Object _
) As XlXmlImportResult

public XlXmlImportResult XmlImport(
    string url,
    out XmlMap importMap,
    Object overwrite,
    Object destination
)

Parametry

  • url
    Typ: System.String
    Adres URL (adres URL) lub jednolitego nazewnictwa ścieżkę konwencji UNC do pliku danych XML.
  • overwrite
    Typ: System.Object
    Jeżeli nie określono wartości dla parametru Destination, to ten parametr określa, czy zastąpić dane, która zostały zmapowane do mapy schematu określonej w parametrze ImportMap.Ustaw true, aby zastąpić dane lub false, aby dołączyć nowe dane do istniejących danych.Wartością domyślną jest true.Jeśli określono wartość dla parametru Destination, to ten parametr określa, czy należy zastąpić istniejące dane.Ustaw true, aby zastąpić istniejące dane lub false, aby anulować operację importowania, jeśli dane zostaną zastąpione.Wartością domyślną jest true.
  • destination
    Typ: System.Object
    Dane zostaną zaimportowane do nowej listy XML w Range określony.

Wartość zwracana

Typ: Microsoft.Office.Interop.Excel.XlXmlImportResult
Jedna z wartości XlXmlImportResult.

Uwagi

Aby importować dane do istniejącego mapowania, nie należy określać wartości dla parametru Destination.

Poniższe warunki sprawiają, że metoda generuje czasu wykonywania:

  • Określone dane XML zawierają błędy składni.

  • Proces importowania został anulowany, ponieważ określone dane nie pasują do arkusza.

Użycie XmlImportXml metodę importowania danych XML, który został poprzednio załadowany do pamięci.

Parametry opcjonalne

Informacje na temat parametrów opcjonalnych można wyświetlić na Parametry opcjonalne w rozwiązaniach Office.

Przykłady

Poniższy przykład kodu tworzy XmlMap oparty na schemacie generowane z DataSet, pisze DataSet do pliku XML, a następnie używa XmlImport metoda zapisu danych w pliku XML do zakresu w arkuszu Sheet1.

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

Private Sub WorkbookXmlImport()

    ' Create a new DataTable.
    Dim ds As New DataSet()
    Dim dt As DataTable = ds.Tables.Add("Customers")
    dt.Columns.Add(New DataColumn("LastName"))
    dt.Columns.Add(New DataColumn("FirstName"))

    ' Add a new row to the DataTable.
    Dim dr As DataRow = dt.NewRow()
    dr("LastName") = "Chan"
    dr("FirstName") = "Gareth"
    dt.Rows.Add(dr)

    ' Add a new XML map and write the XML to a file.
    Dim xmlMap1 As Excel.XmlMap = Me.XmlMaps.Add(ds.GetXmlSchema(), _
        "NewDataSet")
    ds.WriteXml("C:\Customers.xml")

    ' Import the XML from the file.
    Dim range1 As Excel.Range = Globals.Sheet1.Range("A1")
    Me.XmlImport("C:\Customers.xml", xmlMap1, True, _
        range1)
End Sub

private void WorkbookXmlImport()
{
    // Create a new DataTable.
    DataSet ds = new DataSet();
    DataTable dt = ds.Tables.Add("Customers");
    dt.Columns.Add(new DataColumn("LastName"));
    dt.Columns.Add(new DataColumn("FirstName"));

    // Add a new row to the DataTable.
    DataRow dr = dt.NewRow();
    dr["LastName"] = "Chan";
    dr["FirstName"] = "Gareth";
    dt.Rows.Add(dr);

    // Add a new XML map and write the XML to a file.
    Excel.XmlMap xmlMap1 = this.XmlMaps.Add(ds.GetXmlSchema(),
        "NewDataSet");
    ds.WriteXml(@"C:\Customers.xml");

    // Import the XML from the file.
    Excel.Range range1 = Globals.Sheet1.Range["A1"];
    this.XmlImport(@"C:\Customers.xml", out xmlMap1, true, range1);
}

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

WorkbookBase Klasa

Przestrzeń nazw Microsoft.Office.Tools.Excel