Sdílet prostřednictvím

Workbook.XmlImport-Methode (2007 System)

  • Článek

Aktualisiert: November 2007

Importiert eine XML-Datendatei in die aktuelle Arbeitsmappe.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v9.0 (in Microsoft.Office.Tools.Excel.v9.0.dll)

Syntax

'Declaration
Public Function XmlImport ( _
    Url As String, _
    <OutAttribute> ByRef ImportMap As XmlMap, _
    Overwrite As Object, _
    Destination As Object _
) As XlXmlImportResult
'Usage
Dim instance As Workbook
Dim Url As String
Dim ImportMap As XmlMap
Dim Overwrite As Object
Dim Destination As Object
Dim returnValue As XlXmlImportResult

returnValue = instance.XmlImport(Url, _
    ImportMap, Overwrite, Destination)

public XlXmlImportResult XmlImport(
    string Url,
    out XmlMap ImportMap,
    Object Overwrite,
    Object Destination
)

Parameter

  • Url
    Typ: System.String

    Ein URL-Pfad (Uniform Resource Locator) oder UNC-Pfad (Uniform Naming Convention) zu einer XML-Datendatei.

  • Overwrite
    Typ: System.Object

    Wenn für den Destination-Parameter kein Wert angegeben ist, gibt dieser Parameter an, ob Daten, die der mit dem ImportMap-Parameter angegebenen Schemazuordnung zugeordnet sind, überschrieben werden sollen. true, wenn die Daten überschrieben werden sollen, bzw. false, um die neuen Daten an die vorhandenen Daten anzuhängen. Der Standardwert ist true. Wenn für den Destination-Parameter ein Wert angegeben ist, gibt dieser Parameter an, ob vorhandene Daten überschrieben werden sollen. true, wenn vorhandene Daten überschrieben werden sollen, bzw. false, um den Importvorgang abzubrechen, wenn durch diesen Daten überschrieben würden. Der Standardwert ist true.

  • Destination
    Typ: System.Object

    Die Daten werden in den angegebenen Range einer neue XML-Liste importiert.

Rückgabewert

Typ: Microsoft.Office.Interop.Excel.XlXmlImportResult

Einer der XlXmlImportResult-Werte.

Hinweise

Um Daten in eine vorhandene Zuordnung zu importieren, geben Sie keinen Wert für den Destination-Parameter an.

Unter den folgenden Bedingungen generiert diese Methode Laufzeitfehler:

  • Die angegebenen XML-Daten enthalten Syntaxfehler.

  • Der Importprozess wurde abgebrochen, da die angegebenen Daten nicht in das Arbeitsblatt passen.

Importieren Sie mithilfe der XmlImportXml-Methode zuvor in den Arbeitsspeicher geladene XML-Daten.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parametern in Office-Projektmappen.

Beispiele

Im folgenden Codebeispiel wird auf Grundlage eines durch ein DataSet erzeugten Schemas eine XmlMap erstellt und das DataSet in eine XML-Datei geschrieben. Anschließend wird die XmlImport-Methode verwendet, um die Daten der XML-Datei in einen Bereich im Arbeitsblatt Sheet1 zu schreiben.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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", missing];
    this.XmlImport(@"C:\Customers.xml", out xmlMap1, true, range1);
}

Berechtigungen

Siehe auch

Referenz

Workbook-Klasse

Workbook-Member

Microsoft.Office.Tools.Excel-Namespace