WorkbookBase.XmlImport-Methode

Artikel
05/07/2013

Importiert eine XML-Datendatei in die aktuelle Arbeitsmappe.

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

Syntax

'Declaration
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
)

Parameter

url
Typ: System.String
Ein URL-Pfad (Uniform Resource Locator) oder UNC-Pfad (Uniform Naming Convention) zu einer XML-Datendatei.

importMap
Typ: Microsoft.Office.Interop.Excel.XmlMap%
Die beim Importieren der Datei anzuwendende Schemazuordnung.

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 Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird auf Grundlage eines durch ein XmlMap erzeugten Schemas eine DataSet 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"];
    this.XmlImport(@"C:\Customers.xml", out xmlMap1, true, range1);
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

WorkbookBase Klasse

Microsoft.Office.Tools.Excel-Namespace

Freigeben über