WorkbookBase.XmlImport(String, XmlMap, Object, Object) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Excel

Zestaw:

Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Importuje plik danych XML do bieżącego skoroszytu.

public Microsoft.Office.Interop.Excel.XlXmlImportResult XmlImport (string url, out Microsoft.Office.Interop.Excel.XmlMap importMap, object overwrite, object destination);

member this.XmlImport : string * XmlMap * obj * obj -> Microsoft.Office.Interop.Excel.XlXmlImportResult

Public Function XmlImport (url As String, ByRef importMap As XmlMap, Optional overwrite As Object, Optional destination As Object) As XlXmlImportResult

Parametry

url

String

Jednolity lokalizator zasobów (URL) lub jednolita ścieżka konwencji nazewnictwa (UNC) do pliku danych XML.

importMap

XmlMap

Mapa schematu do zastosowania podczas importowania pliku.

overwrite

Object

Jeśli dla parametru Destination nie określono wartości, ten parametr określa, czy zastąpić dane, które zostały zamapowane na mapę schematu określoną w parametrze ImportMap . Ustaw wartość na wartość , aby true zastąpić dane lub false dołączyć nowe dane do istniejących danych. Wartość domyślna to true. Jeśli dla parametru Destination określono wartość, ten parametr określa, czy zastąpić istniejące dane. Ustaw wartość na true wartość , aby zastąpić istniejące dane lub false anulować importowanie, jeśli dane zostaną zastąpione. Wartość domyślna to true.

destination

Object

Dane zostaną zaimportowane do nowej listy XML w Range określonej lokalizacji.

Zwraca

XlXmlImportResult

Jedna z XlXmlImportResult wartości.

Przykłady

Poniższy przykład kodu tworzy obiekt XmlMap oparty na schemacie wygenerowanym na podstawie elementu DataSet, zapisuje DataSet element w pliku XML, a następnie używa XmlImport metody do zapisywania danych w pliku XML do zakresu w arkuszu Sheet1.

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

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);
}

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

Uwagi

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

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.

XmlImportXml Użyj metody , aby zaimportować dane XML, które zostały wcześniej załadowane do pamięci.

Parametry opcjonalne

Aby uzyskać informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach pakietu Office.