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
    Uniform resource locator (URL) lub jednolitego nazewnictwa ścieżkę konwencji UNC do pliku danych XML.
  • overwrite
    Typ: System.Object
    Jeśli nie określono wartość dla Destination parametr, a następnie ten parametr określa, czy do zastępowania danych, która została zamapowana do mapy schematu, określonej w ImportMap parametru.Zestaw do true do zastępowania danych lub false dołączyć nowe dane do istniejących danych.Wartością domyślną jest true.Jeżeli określono wartość dla Destination parametr, a następnie ten parametr określa, czy zastąpić istniejące dane.Zestaw do true do zastępowania istniejących danych lub false Aby anulować operację importowania, jeśli dane byłyby zastępowane.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
Jednym z XlXmlImportResult wartości.

Uwagi

Nie należy określać wartość dla Destination parametr, jeśli chcesz zaimportować dane do istniejącego mapowania.

Ta metoda powoduje wystąpienie błędów wykonania spowoduje, że następujące warunki:

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

  • Proces importowania zostało anulowane, 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

Aby uzyskać informacje o opcjonalnych parametrów, zobacz Parametry opcjonalne w rozwiązania dla pakietu Office.

Przykłady

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

Ten przykład dotyczy dostosowywania 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